Skip to content

DevOps role-play with Scrum methodology

Field Value
Source Obsidian · Claudian plugin
Session ses_f46898013ffef48QJWtrpMumKt
Started 2026-09-19 11:39
Messages 51
Parts 260 (text+patch+tool) · 39 reasoning · 72 tool calls
Model opencode:big-pickle
Directory /home/sambasene/obsidian/Vault

rather than learning devops the normal way let’s do something else, you develop something as the developer, you also take the role of operator, and then you also do the link as the devops and document separately what each of these three do and explain the how, the why, etc. use a methodology too like agile scrum or whatever while explaining what it is and why it’s used

<linked_content path=“local run.md” />

read — {"filePath": "/home/sambasene/obsidian/Vault/local run.md"}

<path>/home/sambasene/obsidian/Vault/local run.md</path>
<type>file</type>
<content>
1: # done
2:
3: freecodecamp.org
4: the odin project
5: appwrite
6: misskey
7: arterisk
8: virtual box - kali - 950 tester@
9: idle twilight
10: nextcloud
11: bagisto
12: openclaw
13: hermes
14: opencode
15: nextcloud
16: rocket chat
17: linux journey
18: n8n
19: peertube
20: strapi
21: dartpad
22: matrix
23: element
24:
25:
26: ****
27: # to do
28:
29:
30: monkey type
31: supabase
32:
33:
34: kaggle
35: moodle
36: over the wire bandit
37: rust desk
38:
39:
40:
41: ---
42:
43: # failed
44:
45: athena vm 950 nine 246 ten
46: freepbx
47:
(End of file - total 47 lines)
</content>

bash — date

Sat Sep 19 11:39:09 AM GMT 2026

Let me first look at the context — your vault, the linked file, and what’s available in the environment — then I’ll set up this exercise properly.

skill — {"name": "local-app-setup"}

<skill_content name="local-app-setup">
# Skill: local-app-setup
# Local Application Setup (with bilingual documentation)
## Overview
When the user says they want to set up, install, configure, or run some app/software/service locally, this skill drives two parallel tracks every time:
1. **Track B (get it running)** — Work with the user to install and run the thing: give exact commands, capture results, troubleshoot.
2. **Track D (document it bilingually)** — Create and progressively maintain a set of Obsidian notes: a **French** report, an **English** report, and **side/companion files** (setup guide, config template, results log). All written in the **user's first-person voice**.
Run *
…[truncated]

bash — `for cmd in docker node npm python3 pip3 git systemctl nginx curl sqlite3 go; do printf “%-12s” “$cmd”; command -v $cmd >/dev/null 2>&1 && echo “OK ($($cmd –version 2>/dev/null | head -1))” || echo “m

…[truncated]`

docker missing
node OK (v24.20.0)
npm OK (11.19.0)
python3 OK (Python 3.14.7)
pip3 missing
git OK (git version 2.55.0)
systemctl missing
nginx missing
curl OK (curl 8.21.0 (Linux) libcurl/8.21.0 OpenSSL/3.5.8 zlib/1.3.1.zlib-ng zstd/1.5.7 libidn2/2.3.8 libpsl/0.23.3 nghttp2/1.70.0 ngtcp2/1.25.0 nghttp3/1.18.0)
sqlite3 OK (3.53.4 2026-07-24 19:02:57 bf7c7f30031888f4e796e429ab3978879485813aaca6f641c7b33e4e09459bcc (64-bit))
go missing

glob — {"pattern": "Local Services.md"}

/home/sambasene/obsidian/Vault/Local Services.md

read — {"filePath": "/home/sambasene/obsidian/Vault/Local Services.md"}

<path>/home/sambasene/obsidian/Vault/Local Services.md</path>
<type>file</type>
<content>
1: # Local Services
2:
3: Everything that runs locally on this machine, with its link and restart command. Update the Status column whenever a service starts or stops.
4:
5: > 🐧 **Machine moved to Fedora 44** (2026-09-18). Only OpenClaw has been re-verified on Linux — other rows keep their Windows-era "last seen" and need re-checking. Restart commands below are the Linux equivalents.
6:
7: | Service | Link(s) | Restart command if down | Status | Last seen |
8: | ---------------------------------------------------- | ------------------------------------------------------------------------------- | ---
…[truncated]

Good context. The sandbox has Node 24 + Python 3.14 + git + sqlite3 (no docker/systemd — so “operation” will be real but host-friendly, and I’ll document the production equivalents). Let me check the vault layout and where code lives here.

bash — ls /home/sambasene/obsidian/Vault/ && echo "---" && ls ~/dev 2>/dev/null || echo "no ~/dev"

2026-08-30.md
2026-09-07.md
AGENTS.md
Apps
Artifacts
Auto Biography.md
Cahier des Charges - PolyPortal.md
C-escape-characters.png
chrome exploration result.md
Claude Code.md
Commission Pedagogique.md
DartPad_results.md
DevOps.md
Documentation
drafts
ESP
Excalidraw
Fedora Setup.md
Flutter Installation Process.md
Flutter Installation Process Raw.md
freeCodeCamp.org.md
FreePBX Setup Commands Results.md
Free pbx setup past commands.md
Google main.png
Greatest of All Time - Idle Zelus.md
Hermes Setup Results.md
Idle Twilight
Java.md
killing.md
Learn
Light (1).png
Light.png
Linux.md
local run.md
Local Services.md
Mathematiques pour le signal discret.md
Matrix Setup Commands Results.md
meet com ped
…[truncated]

glob — {"pattern": "Learn/**"}

/home/sambasene/obsidian/Vault/Learn/Learn.md
/home/sambasene/obsidian/Vault/Learn/Local AI Models/Local AI Models.md
/home/sambasene/obsidian/Vault/Learn/Graphic Design & Editing/Graphic Design & Editing.md
/home/sambasene/obsidian/Vault/Learn/The Odin Project/The Odin Project.md
/home/sambasene/obsidian/Vault/Learn/freeCodeCamp/freeCodeCamp.md
/home/sambasene/obsidian/Vault/Learn/Graphic Design & Editing/Figma/Figma.md
/home/sambasene/obsidian/Vault/Learn/freeCodeCamp/README.md
/home/sambasene/obsidian/Vault/Learn/freeCodeCamp/freeCodeCamp.lnk
/home/sambasene/obsidian/Vault/Learn/Library/Websites.md
/home/sambasene/obsidian/Vault/Learn/Library/PDF Documents.md
/home/sambasene/obsidian/Vaul
…[truncated]

Interesting — there’s already a DevOps.md and Touch Typing.md in the vault, and monkeytype is cloned in ~/dev. Let me check those before choosing the project.

read — {"filePath": "/home/sambasene/obsidian/Vault/DevOps.md"}

<path>/home/sambasene/obsidian/Vault/DevOps.md</path>
<type>file</type>
<content>
1: # Version Control with Git
2:
(End of file - total 2 lines)
</content>

read — {"filePath": "/home/sambasene/obsidian/Vault/Touch Typing.md"}

<path>/home/sambasene/obsidian/Vault/Touch Typing.md</path>
<type>file</type>
<content>
1: Touch typing can be said to be the ability to write fast on the keyboard while using all the ten fingers after allocating each finger some very specific letters to type on each rows. those rows are mainly the home row, and the other two. i forgot how they're called so it doesn't matter.
(End of file - total 1 lines)
</content>

This is a perfect setup for the experiment. Your vault already has a DevOps.md skeleton, a Touch Typing.md note, and monkeytype cloned in ~/dev but not running. So here’s the plan:

The experiment: I’ll play 3 people, and you’ll see DevOps from inside the machine.

  • 🧑💻 Developer — builds a tiny typing-test web app (“TinyType”, a mini-monkeytype) end to end
  • 🛠️ Operator — runs it, keeps it alive, healthy, backed up
  • 🔗 DevOps — the glue: git flow, tests, CI, deployment automation
  • 📐 Methodology — we run it as one Scrum sprint, and I document what Scrum is and why

Code lives in ~/dev/tinytype (matching your ~/dev/ convention), docs in Learn/DevOps/DevOps Playground/.

todowrite — `{“todos”: [{“content”: “Check env: npm registry access, ~/dev writable, node:sqlite available”, “status”: “in_progress”, “priority”: “high”}, {“content”: “Sprint 0: write Agile & Scrum methodology doc

…[truncated]`

[
{
"content": "Check env: npm registry access, ~/dev writable, node:sqlite available",
"status": "in_progress",
"priority": "high"
},
{
"content": "Sprint 0: write Agile & Scrum methodology doc (what it is, why, ceremonies)",
"status": "pending",
"priority": "high"
},
{
"content": "DEV: scaffold TinyType repo (package.json, server.js, db.js, UI)",
"status": "pending",
"priority": "high"
},
{
"content": "DEV: write + run tests (API + unit) using node:test",
"status": "pending",
"priority": "high"
},
{
"content": "OPS: run service with start/stop/status scripts, health checks, logging, backup",
"status": "pending",
"priority": "high"
},
{
"content": "DEVOPS: git flo
…[truncated]

bash — `npm view express version 2>&1 | tail -1; mkdir -p ~/dev/tinytype && touch /dev/tinytype/.write-test && echo “/dev writable”; node -e “const {DatabaseSync}=require(‘node:sqlite’); const db=new Databa

…[truncated]`

5.2.1
~/dev writable
node:sqlite OK

Environment is green: npm registry reachable (Express 5.2.1), ~/dev/tinytype writable, node:sqlite works. Sprint 0 — let me lay the foundation: the methodology doc that frames the whole exercise.

bash — mkdir -p "/home/sambasene/obsidian/Vault/Learn/DevOps/DevOps Playground" && ls "/home/sambasene/obsidian/Vault/Learn/DevOps/" 2>/dev/null || true

DevOps Playground

write — `{“filePath”: “/home/sambasene/obsidian/Vault/Learn/DevOps/DevOps Playground/0. Agile & Scrum.md”, “content”: “# Agile & Scrum — the methodology behind the DevOps Playground\n\n> Part of the [[DevOps P

…[truncated]`

Wrote file successfully.

Sprint foundation is in. Now I put on the Developer hat and build the actual product — TinyType, a mini-monkeytype typing trainer. Why this project? It’s on your to-do list (monkey type), you’re actively learning touch typing ([[Touch Typing]]), and it’s small enough that one sprint is realistic — which is exactly what Agile demands.

write — `{“content”: “{\n "name": "tinytype",\n "version": "0.1.0",\n "description": "TinyType — a minimal typing trainer (mini-monkeytype). Built to learn DevOps by doing.",\n "type": "module"

…[truncated]`

Wrote file successfully.

write — `{“content”: “/**\n * texts.js — the "content" of TinyType.\n *\n * WHY a fixed list instead of fetching from an API:\n * - zero external dependency → the app works offline, forever\n * - determinist

…[truncated]`

Wrote file successfully.

write — `{“content”: “/**\n * db.js — SQLite persistence.\n *\n * WHY node:sqlite (built-in since Node 22.5):\n * - zero npm native dependencies → no build step, no version mismatch pain\n * - synchronous API

…[truncated]`

Wrote file successfully.

write — `{“content”: “/**\n * app.js — the HTTP application (routes + middleware wiring).\n *\n * WHY app vs server split:\n * - tests import createApp() and boot it on an ephemeral port\n * - the real entrypo

…[truncated]`

Wrote file successfully.

write — `{“content”: “/**\n * server.js — entrypoint. Kept tiny on purpose (see src/app.js).\n *\n * 12-factor habit: configuration comes from the environment, not the code.\n * PORT → which port to listen on

…[truncated]`

Wrote file successfully.

Backend done. Now the frontend — plain HTML/CSS/JS, deliberately no framework and no build step:

write — `{“content”: “\n<html lang="en">\n\n <meta charset="UTF-8" />\n <meta name="viewport" content="width=device-width, initial-scale=1.0" />\n TinyType — typing trainer<</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">write</code></strong> — `{“content”: “/* style.css — minimal, dark, focused. No UI framework on purpose:\n a typing trainer should load instantly, even on a weak machine. <em>/\n</em> { box-sizing: border-box; }\nbody {\n margin: 0;</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">write</code></strong> — `{“content”: “/* app.js — client logic, vanilla on purpose. No framework needed for\n one interactive screen; every byte here is code the dev owns. */\n\nconst $ = id => document.getElementById(id);\nc</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">write</code></strong> — `{“content”: “/**\n * test/api.test.js — integration tests over the real HTTP surface.\n *\n * WHY node:test: it ships inside Node since v18. No jest/vitest install,\n * no config file, no extra moving</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">bash</code></strong> — <code dir="auto">npm install express --save 2>&1 | tail -3</code></p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">run `npm fund` for details</span></div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">found 0 vulnerabilities</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code=" run `npm fund` for detailsfound 0 vulnerabilities"><div></div></button></div></figure></div> <p><strong><code dir="auto">bash</code></strong> — <code dir="auto">npm test 2>&1 | tail -25</code></p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">at resolveForCJSWithHooks (node:internal/modules/cjs/loader:1169:12)</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">at Module._load (node:internal/modules/cjs/loader:1341:5)</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">at wrapModuleLoad (node:internal/modules/cjs/loader:261:19)</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">at Module.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:154:5)</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">at node:internal/main/run_main_module:33:47 {</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">code: 'MODULE_NOT_FOUND',</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">requireStack: []</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">}</span></div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Node.js v24.20.0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">✖ test (26.303375ms)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ tests 1</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ suites 0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ pass 0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ fail 1</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ cancelled 0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ skipped 0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ todo 0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ duration_ms 33.35252</span></div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">✖ failing tests:</span></div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">test at test:1:1</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">✖ test (26.303375ms)</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">'test failed'</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code=" at resolveForCJSWithHooks (node:internal/modules/cjs/loader:1169:12) at Module._load (node:internal/modules/cjs/loader:1341:5) at wrapModuleLoad (node:internal/modules/cjs/loader:261:19) at Module.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:154:5) at node:internal/main/run_main_module:33:47 { code: 'MODULE_NOT_FOUND', requireStack: []}Node.js v24.20.0✖ test (26.303375ms)ℹ tests 1ℹ suites 0ℹ pass 0ℹ fail 1ℹ cancelled 0ℹ skipped 0ℹ todo 0ℹ duration_ms 33.35252✖ failing tests:test at test:1:1✖ test (26.303375ms) 'test failed'"><div></div></button></div></figure></div> <p>Odd failure — let me see the full error:</p> <p><strong><code dir="auto">bash</code></strong> — <code dir="auto">node --test test/ 2>&1 | head -30</code></p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">node:internal/modules/cjs/loader:1568</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">throw err;</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">^</span></div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Error: Cannot find module '/home/sambasene/dev/tinytype/test'</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">at Module._resolveFilename (node:internal/modules/cjs/loader:1564:15)</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">at wrapResolveFilename (node:internal/modules/cjs/loader:1118:27)</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">at defaultResolveImplForCJSLoading (node:internal/modules/cjs/loader:1142:10)</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">at resolveForCJSWithHooks (node:internal/modules/cjs/loader:1169:12)</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">at Module._load (node:internal/modules/cjs/loader:1341:5)</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">at wrapModuleLoad (node:internal/modules/cjs/loader:261:19)</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">at Module.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:154:5)</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">at node:internal/main/run_main_module:33:47 {</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">code: 'MODULE_NOT_FOUND',</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">requireStack: []</span></div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">…[truncated]</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="node:internal/modules/cjs/loader:1568 throw err; ^Error: Cannot find module '/home/sambasene/dev/tinytype/test' at Module._resolveFilename (node:internal/modules/cjs/loader:1564:15) at wrapResolveFilename (node:internal/modules/cjs/loader:1118:27) at defaultResolveImplForCJSLoading (node:internal/modules/cjs/loader:1142:10) at resolveForCJSWithHooks (node:internal/modules/cjs/loader:1169:12) at Module._load (node:internal/modules/cjs/loader:1341:5) at wrapModuleLoad (node:internal/modules/cjs/loader:261:19) at Module.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:154:5) at node:internal/main/run_main_module:33:47 { code: 'MODULE_NOT_FOUND', requireStack: []…[truncated]"><div></div></button></div></figure></div> <p>The <code dir="auto">test/</code> positional arg isn’t treated as a directory in this Node version. Plain <code dir="auto">node --test</code> auto-discovers <code dir="auto">test/*.test.js</code> — that’s cleaner anyway:</p> <p><strong><code dir="auto">edit</code></strong> — <code dir="auto">{"filePath": "/home/sambasene/dev/tinytype/package.json", "oldString": "\"test\": \"node --test test/\",", "newString": "\"test\": \"node --test\","}</code></p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Edit applied successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Edit applied successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">bash</code></strong> — <code dir="auto">npm test 2>&1 | tail -15</code></p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">✔ health endpoint answers ok from a real DB (31.826828ms)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">✔ text endpoint returns a passage with a word count (4.518509ms)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">✔ saving a result then listing it round-trips (16.739049ms)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">✔ results list respects the limit and caps at 100 (2.836436ms)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">✔ invalid results are rejected with 400 — server does not trust clients (16.063185ms)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">✔ unit: wordCount splits on whitespace (0.213624ms)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ tests 6</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ suites 0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ pass 6</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ fail 0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ cancelled 0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ skipped 0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ todo 0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ duration_ms 201.644282</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="✔ health endpoint answers ok from a real DB (31.826828ms)✔ text endpoint returns a passage with a word count (4.518509ms)✔ saving a result then listing it round-trips (16.739049ms)✔ results list respects the limit and caps at 100 (2.836436ms)✔ invalid results are rejected with 400 — server does not trust clients (16.063185ms)✔ unit: wordCount splits on whitespace (0.213624ms)ℹ tests 6ℹ suites 0ℹ pass 6ℹ fail 0ℹ cancelled 0ℹ skipped 0ℹ todo 0ℹ duration_ms 201.644282"><div></div></button></div></figure></div> <p>6/6 tests green. Quick dev smoke test — does it actually run? Then hand the increment to git:</p> <p><strong><code dir="auto">bash</code></strong> — `node server.js > /tmp/tinytype-smoke.log 2>&1 & SERVER_PID=$!; sleep 1.5; echo “— health —”; curl -s <a href="http://127.0.0.1:3417/api/health">http://127.0.0.1:3417/api/health</a>; echo; echo “— text —”; curl -s <a href="http://127.0.0.1:3417/api/">http://127.0.0.1:3417/api/</a></p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">--- health ---</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">{"status":"ok","uptimeSec":2}</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">--- text ---</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">{"id":"t1","text":"practice makes permanent so be careful what you practice every single day","wordCount":12}</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">--- post result ---</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">{"id":1}</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">--- results ---</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">[{"id":1,"wpm":71,"accuracy":98,"duration_sec":34,"created_at":"2026-09-19 11:45:13"}]</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">--- server log ---</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">[tinytype] listening on http://127.0.0.1:3417 (db: /home/sambasene/dev/tinytype/data/tinytype.db)</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="--- health ---{"status":"ok","uptimeSec":2}--- text ---{"id":"t1","text":"practice makes permanent so be careful what you practice every single day","wordCount":12}--- post result ---{"id":1}--- results ---[{"id":1,"wpm":71,"accuracy":98,"duration_sec":34,"created_at":"2026-09-19 11:45:13"}]--- server log ---[tinytype] listening on http://127.0.0.1:3417 (db: /home/sambasene/dev/tinytype/data/tinytype.db)"><div></div></button></div></figure></div> <p>The Developer’s increment works end to end — API, DB, results round-trip. As a real developer would, we lock the milestone into version control. Git is where Dev and Ops meet, so this commit is the first artifact the DevOps mental model builds on:</p> <p><strong><code dir="auto">bash</code></strong> — `printf ‘node_modules/\ndata/\n*.log\n’ > .gitignore && git init -b main 2>&1 | head -1 && git add -A && git commit -m “feat: TinyType v0.1 — typing trainer API + UI + tests</p> <p>First runnable increment (</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Initialized empty Git repository in /home/sambasene/dev/tinytype/.git/</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">create mode 100644 src/texts.js</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">create mode 100644 test/api.test.js</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Initialized empty Git repository in /home/sambasene/dev/tinytype/.git/ create mode 100644 src/texts.js create mode 100644 test/api.test.js"><div></div></button></div></figure></div> <p><strong>Developer hat off. Operator hat on.</strong> 🛠️ The code works on a dev machine — the Operator’s job is making it <em>dependable</em>: supervised start/stop, health probes, logs, backups, and a production-grade unit file. In this sandbox there’s no systemd/docker, so the Operator writes real scripts here <strong>and</strong> the systemd unit that would run on your Fedora host — documenting both, because the <em>why</em> is the lesson.</p> <p><strong><code dir="auto">write</code></strong> — `{“content”: “#!/bin/sh\n# start.sh — Operator: bring TinyType up, detached, with logs + PID file.\n#\n# WHY nohup + a PID file here: the Obsidian sandbox has no systemd, so we\n# run the simplest supe</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">write</code></strong> — `{“content”: “#!/bin/sh\n# stop.sh — Operator: graceful shutdown.\n#\n# WHY SIGTERM first (not SIGKILL): Node/Express gets a chance to finish\n# in-flight requests and SQLite flushes cleanly. SIGKILL (</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">write</code></strong> — `{“content”: “#!/bin/sh\n# status.sh — Operator: is it up, and is it HEALTHY?\n#\n# WHY probe the endpoint and not just check the process: a process can be\n# alive while wedged (deadlocked, DB locked,</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">write</code></strong> — `{“content”: “#!/bin/sh\n# health.sh — Operator: one-shot health probe, exit code 0/1.\n# Used by scripts and by cron/systemd timers for alerting.\nset -eu\nPORT="${TINYTYPE_PORT:-3417}"\ncurl -sf "</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">write</code></strong> — <code dir="auto">{"content": "#!/bin/sh\n# backup.sh — Operator: consistent snapshot of the live SQLite DB.\n#\n# WHY </code>sqlite3 .backup<code dir="auto">and NOT</code>cp`: the DB runs in WAL mode, so the main\n# .db file may not contain th</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">write</code></strong> — `{“content”: “# tinytype.service — production unit for the real host (systemd user unit).\n#\n# WHY systemd on the host: it gives us supervision (auto-restart), logging\n# (journalctl), lifecycle (star</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p>Scripts ready. Now the Operator’s real verification — boot, probe, mutate, snapshot, restore, restart:</p> <p><strong><code dir="auto">bash</code></strong> — `chmod +x scripts/*.sh && echo “=== 1. START ===” && ./scripts/start.sh && echo && echo “=== 2. STATUS ===” && ./scripts/status.sh && echo && echo “=== 3. ADD A RESULT (simulating a user) ===” && curl</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">=== 1. START ===</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">started pid 33212 on port 3417 (db /home/sambasene/dev/tinytype/data/tinytype.db)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">{"status":"ok","uptimeSec":1}</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">=== 2. STATUS ===</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">process: RUNNING (pid 33212)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">health: OK -> {"status":"ok","uptimeSec":1}</span></div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">=== 3. ADD A RESULT (simulating a user) ===</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">{"id":2}</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">=== 4. BACKUP ===</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">backup ok -> backups/tinytype-20260919-114624.db (16K)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">retention: kept last 7</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">=== 5. RESTORE PROOF (restore into scratch db, compare rows) ===</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">original count: 2</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">restored count: 2</span></div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">=== 6. STOP (graceful) ===</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">stopped pid 33212</span></div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">=== 7. STATUS AFTER STOP (expect DOWN) ===</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">TinyType is DOWN</span></div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">=== 8. RESTART — leave it running ===</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">started pid 33262 on port 3417 (db /home/sambasene/dev/tinytype/data/tinytype.db)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">{</span></div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">…[truncated]</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="=== 1. START ===started pid 33212 on port 3417 (db /home/sambasene/dev/tinytype/data/tinytype.db){"status":"ok","uptimeSec":1}=== 2. STATUS ===process: RUNNING (pid 33212)health: OK -> {"status":"ok","uptimeSec":1}=== 3. ADD A RESULT (simulating a user) ==={"id":2}=== 4. BACKUP ===backup ok -> backups/tinytype-20260919-114624.db (16K)retention: kept last 7=== 5. RESTORE PROOF (restore into scratch db, compare rows) ===original count: 2restored count: 2=== 6. STOP (graceful) ===stopped pid 33212=== 7. STATUS AFTER STOP (expect DOWN) ===TinyType is DOWN=== 8. RESTART — leave it running ===started pid 33262 on port 3417 (db /home/sambasene/dev/tinytype/data/tinytype.db){…[truncated]"><div></div></button></div></figure></div> <p>Full operator loop proven: <strong>start → status → health → mutate → backup → restore-verified → clean stop → restart</strong>. The service is now live on pid 33262. Locking in the ops increment:</p> <p><strong><code dir="auto">bash</code></strong> — `git add -A && git commit -m “ops: supervised lifecycle — start/stop/status/health/backup + systemd unit</p> <p>Operator deliverable (US-5):</p> <ul> <li>scripts: start.sh (nohup+PID), stop.sh (graceful SIGTERM), statu</li> </ul> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">create mode 100755 scripts/stop.sh</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code=" create mode 100755 scripts/stop.sh"><div></div></button></div></figure></div> <p>Ops increment committed. <strong>Now the DevOps hat — the link between the two worlds.</strong> 🧲 The Developer writes code, the Operator runs infrastructure. DevOps builds the <em>pipeline</em> that makes both boring: a test gate that blocks bad code before it exists (local CI), the same tests in GitHub Actions (remote CI), and an automated deployment that ships good code with one command (CD).</p> <p><strong><code dir="auto">write</code></strong> — `{“content”: “#!/bin/sh\n# pre-commit — local CI gate (the "shift-left" move).\n#\n# WHY a pre-commit hook AND GitHub Actions: the shortest feedback loop is\n# the one at the developer’s own machine.</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">write</code></strong> — `{“content”: “# GitHub Actions CI — the "second line" of the test gate.\n#\n# WHY: the pre-commit hook only guards one machine. CI guards the branch:\n# every push and every pull request runs the tes</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">write</code></strong> — `{“content”: “#!/bin/sh\n# restart.sh — Operator/DevOps: the standard "recycle" action.\n# Used by deploy.sh after shipping a new version. Stops, starts, verifies.\nset -eu\ncd "$(dirname "$0")/..</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">write</code></strong> — `{“content”: “#!/bin/sh\n# deploy.sh — DevOps: ship the current repo state to the running service.\n#\n# The deployment recipe is deliberately the same everywhere — that’s the\n# whole point of deploym</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">write</code></strong> — `{“content”: “# TinyType in a container — the "same everywhere" packaging option.\n# NOTE (honest artifact): no docker in the Obsidian sandbox, so this file\n# is written but NOT executed yet. Test i</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">write</code></strong> — `{“content”: “# Container orchestration for TinyType — host port 3418 to avoid clashing\n# with the bare-metal instance on 3417 (both can run at once).\nservices:\n tinytype:\n build: .\n ports:\n - "</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p>Now the README and the key teaching beat — <strong>proving the pipeline actually blocks broken code</strong>:</p> <p><strong><code dir="auto">write</code></strong> — `{“content”: “# TinyType\n\nA minimal typing trainer (mini-<strong><a href="https://monkeytype.com">monkeytype</a></strong>) built as the hands-on vehicle for learning DevOps by doing — developer, operator and DevOps roles pl</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">bash</code></strong> — <code dir="auto">chmod +x .githooks/pre-commit deploy/deploy.sh scripts/restart.sh && git config core.hooksPath .githooks && echo "hooks installed: $(git config core.hooksPath)"</code></p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">hooks installed: .githooks</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="hooks installed: .githooks"><div></div></button></div></figure></div> <p><strong><code dir="auto">bash</code></strong> — `echo “=== DEMO: developer introduces a regression (health endpoint now says ‘oops’) ===” && sed -i “s/status: ‘ok’/status: ‘oops’/” src/app.js && grep -n “status: ‘oops’” src/app.js && echo && echo “=</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">=== DEMO: developer introduces a regression (health endpoint now says 'oops') ===</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">37: res.json({ status: 'oops', uptimeSec: Math.round(process.uptime()) });</span></div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">=== attempt to commit the broken change ===</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">at async startSubtestAfterBootstrap (node:internal/test_runner/harness:387:3) {</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">generatedMessage: true,</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">code: 'ERR_ASSERTION',</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">actual: 'oops',</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">expected: 'ok',</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">operator: 'strictEqual',</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">diff: 'simple'</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">}</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">exit code: 0</span></div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">=== fix: revert the regression ===</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="=== DEMO: developer introduces a regression (health endpoint now says 'oops') ===37: res.json({ status: 'oops', uptimeSec: Math.round(process.uptime()) });=== attempt to commit the broken change === at async startSubtestAfterBootstrap (node:internal/test_runner/harness:387:3) { generatedMessage: true, code: 'ERR_ASSERTION', actual: 'oops', expected: 'ok', operator: 'strictEqual', diff: 'simple' }exit code: 0=== fix: revert the regression ==="><div></div></button></div></figure></div> <p>The gate <strong>worked</strong> — the broken commit was blocked by the failing test (<code dir="auto">actual: 'oops', expected: 'ok'</code>). My demo chain cut off after the revert step (a grep check exited non-zero), so let me verify the repo state and finish the commit:</p> <p><strong><code dir="auto">bash</code></strong> — <code dir="auto">grep -n "status: 'ok'" src/app.js && git status --short | head -20 && echo "---" && git log --oneline</code></p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">(no output)</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="(no output)"><div></div></button></div></figure></div> <p>No output means the grep found no match — let me inspect what actually happened to the file:</p> <p><strong><code dir="auto">bash</code></strong> — <code dir="auto">head -5 src/app.js; echo "==="; grep -n "status" src/app.js; echo "==="; git status --short | head -25; echo "==="; git log --oneline</code></p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">/**</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">* app.js — the HTTP application (routes + middleware wiring).</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">*</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">* WHY app vs server split:</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">* - tests import createApp() and boot it on an ephemeral port</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">===</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">37: res.json({ status: 'oops', uptimeSec: Math.round(process.uptime()) });</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">39: res.status(503).json({ status: 'degraded', error: err.message });</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">63: return res.status(400).json({ error: 'wpm must be 0-400, accuracy 0-100' });</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">66: res.status(201).json({ id: Number(info.lastInsertRowid) });</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">===</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">M src/app.js</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">?? .githooks/</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">?? .github/</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">?? README.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">?? deploy/Dockerfile</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">?? deploy/deploy.sh</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">?? deploy/docker-compose.yml</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">?? scripts/restart.sh</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">===</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">b61bb3c ops: supervised lifecycle — start/stop/status/health/backup + systemd unit</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">6090a4c fe</span></div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">…[truncated]</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="/** * app.js — the HTTP application (routes + middleware wiring). * * WHY app vs server split: * - tests import createApp() and boot it on an ephemeral port===37: res.json({ status: 'oops', uptimeSec: Math.round(process.uptime()) });39: res.status(503).json({ status: 'degraded', error: err.message });63: return res.status(400).json({ error: 'wpm must be 0-400, accuracy 0-100' });66: res.status(201).json({ id: Number(info.lastInsertRowid) });===M src/app.js?? .githooks/?? .github/?? README.md?? deploy/Dockerfile?? deploy/deploy.sh?? deploy/docker-compose.yml?? scripts/restart.sh===b61bb3c ops: supervised lifecycle — start/stop/status/health/backup + systemd unit6090a4c fe…[truncated]"><div></div></button></div></figure></div> <p>This is itself a <strong>real DevOps lesson</strong> — worth keeping, not hiding. I staged the broken file, the commit failed, and <code dir="auto">git checkout -- src/app.js</code> restored from the <em>index</em> (which still held the broken version), not from HEAD. The correct revert is <code dir="auto">git restore</code>. Fixing it now, and this gotcha gets documented in the role docs:</p> <p><strong><code dir="auto">bash</code></strong> — `git restore –staged –worktree src/app.js && grep -n “status: ‘ok’” src/app.js && echo “=== reverted cleanly, tests still green ===” && npm test –silent 2>&1 | grep -E “^ℹ (tests|pass|fail)” && git</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">37: res.json({ status: 'ok', uptimeSec: Math.round(process.uptime()) });</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">=== reverted cleanly, tests still green ===</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ tests 6</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ pass 6</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ fail 0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">▶ pre-commit gate: npm test</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">✔ health endpoint answers ok from a real DB (26.670566ms)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">✔ text endpoint returns a passage with a word count (3.298107ms)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">✔ saving a result then listing it round-trips (18.744206ms)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">✔ results list respects the limit and caps at 100 (5.420173ms)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">✔ invalid results are rejected with 400 — server does not trust clients (11.957655ms)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">✔ unit: wordCount splits on whitespace (0.206673ms)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ tests 6</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ suites 0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ pass 6</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ fail 0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ cancelled 0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ skipped 0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ todo 0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ duration_ms 167.687211</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">▶ gate passed</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">d57f48c ci: delivery pipeline</span></div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">…[truncated]</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="37: res.json({ status: 'ok', uptimeSec: Math.round(process.uptime()) });=== reverted cleanly, tests still green ===ℹ tests 6ℹ pass 6ℹ fail 0▶ pre-commit gate: npm test✔ health endpoint answers ok from a real DB (26.670566ms)✔ text endpoint returns a passage with a word count (3.298107ms)✔ saving a result then listing it round-trips (18.744206ms)✔ results list respects the limit and caps at 100 (5.420173ms)✔ invalid results are rejected with 400 — server does not trust clients (11.957655ms)✔ unit: wordCount splits on whitespace (0.206673ms)ℹ tests 6ℹ suites 0ℹ pass 6ℹ fail 0ℹ cancelled 0ℹ skipped 0ℹ todo 0ℹ duration_ms 167.687211▶ gate passedd57f48c ci: delivery pipeline…[truncated]"><div></div></button></div></figure></div> <p>All three phased commits landed — and notice the pre-commit gate even ran on the final commit (it’s installed and live now). Final proof of the whole DevOps loop: run the actual deployment recipe:</p> <p><strong><code dir="auto">bash</code></strong> — <code dir="auto">./deploy/deploy.sh 2>&1 | grep -vE "^(✔|ℹ| )" && echo "=== final state ===" && ./scripts/status.sh && ls backups/</code></p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">▶ 1/5 tests</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">▶ 2/5 fetch latest code</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">▶ 3/5 install pinned deps</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">▶ 4/5 restart service</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">stopped pid 33262</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">started pid 33660 on port 3417 (db /home/sambasene/dev/tinytype/data/tinytype.db)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">{"status":"ok","uptimeSec":1}process: RUNNING (pid 33660)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">health: OK -> {"status":"ok","uptimeSec":1}</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">▶ 5/5 verify</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">{"status":"ok","uptimeSec":1}deploy ok ✔</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">=== final state ===</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">process: RUNNING (pid 33660)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">health: OK -> {"status":"ok","uptimeSec":1}</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">tinytype-20260919-114624.db</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="▶ 1/5 tests▶ 2/5 fetch latest code▶ 3/5 install pinned deps▶ 4/5 restart servicestopped pid 33262started pid 33660 on port 3417 (db /home/sambasene/dev/tinytype/data/tinytype.db){"status":"ok","uptimeSec":1}process: RUNNING (pid 33660)health: OK -> {"status":"ok","uptimeSec":1}▶ 5/5 verify{"status":"ok","uptimeSec":1}deploy ok ✔=== final state ===process: RUNNING (pid 33660)health: OK -> {"status":"ok","uptimeSec":1}tinytype-20260919-114624.db"><div></div></button></div></figure></div> <p>Pipeline proven end-to-end: <strong>test → pull → install → restart → health verify</strong>, all green, service live. The last third of the sprint is the user’s explicit ask — <strong>documenting each role separately, with the how and the why</strong>. Let me write the three role docs plus the index/retro note.</p> <p><strong><code dir="auto">bash</code></strong> — `mv “/home/sambasene/obsidian/Vault/Learn/DevOps/DevOps Playground/0. Agile & Scrum.md” “/home/sambasene/obsidian/Vault/Learn/DevOps/DevOps Playground/0 - Agile & Scrum.md” && ls “/home/sambasene/obsid</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">0 - Agile & Scrum.md</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="0 - Agile & Scrum.md"><div></div></button></div></figure></div> <p><strong><code dir="auto">write</code></strong> — `{“content”: “# 1 - Role Developer\n\n> Part of the [[DevOps Playground]]. What a developer <em>is</em>, and how/when/why the Developer hat was worn for TinyType this sprint.\n\n—\n\n## What the role is\n\n</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">write</code></strong> — `{“content”: “# 2 - Role Operator\n\n> Part of the [[DevOps Playground]]. What an operator <em>is</em>, and how/when/why the Operator hat was worn for TinyType this sprint.\n\n—\n\n## What the role is\n\nTh</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">write</code></strong> — `{“content”: “# 3 - Role DevOps\n\n> Part of the [[DevOps Playground]]. What DevOps <em>is</em> — the bridge between Developer and Operator — and how the bridge was built for TinyType this sprint.\n\n—\n\n#</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p>Now the index note — the entrance door to the playground, with the Sprint Review (real demo results) and the Retrospective (the honest learning journal):</p> <p><strong><code dir="auto">write</code></strong> — `{“content”: “# DevOps Playground\n\n> <strong>Learn DevOps by doing it — twice-removed from a course.</strong> Instead of reading about pipelines, this playground ran one: the same person (you + your AI copilot) w</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p>Docs done. Now the vault housekeeping — the playground must be wired into your existing notes so it’s discoverable:</p> <p><strong><code dir="auto">edit</code></strong> — `{“filePath”: “/home/sambasene/obsidian/Vault/Local Services.md”, “oldString”: “Also installed but not services (Windows): FileZilla FTP + MercuryMail (ship with XAMPP, not applicable on Fedora).”, “ne</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Edit applied successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Edit applied successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">edit</code></strong> — <code dir="auto">{"filePath": "/home/sambasene/obsidian/Vault/Local Services.md", "oldString": "## Port conflicts\n- :3000 is shared by the fCC API and the Library app (</code>node Apps/Library/server.js`) — run one at a ti</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Edit applied successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Edit applied successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">edit</code></strong> — `{“filePath”: “/home/sambasene/obsidian/Vault/DevOps.md”, “oldString”: “# Version Control with Git”, “newString”: “# DevOps\n\n- 👉 Hands-on learning playground: [[DevOps Playground]] (Developer / Opera</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Edit applied successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Edit applied successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">edit</code></strong> — `{“filePath”: “/home/sambasene/obsidian/Vault/Touch Typing.md”, “oldString”: “Touch typing can be said to be the ability to write fast on the keyboard while using all the ten fingers after allocating e</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Edit applied successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Edit applied successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">edit</code></strong> — `{“filePath”: “/home/sambasene/obsidian/Vault/local run.md”, “newString”: “openclaw\nhermes\nopencode\nnextcloud\nrocket chat\nlinux journey\nn8n\npeertube\nstrapi\ndartpad\nmatrix\nelement\ntinytype”,</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Edit applied successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Edit applied successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">bash</code></strong> — `cd ~/dev/tinytype && echo “=== service ===” && ./scripts/status.sh | head -4 && echo && echo “=== tests ===” && npm test –silent 2>&1 | grep -E “^ℹ (tests|pass|fail)” && echo && echo “=== git history</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">=== service ===</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">process: RUNNING (pid 33660)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">health: OK -> {"status":"ok","uptimeSec":107}</span></div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">=== tests ===</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ tests 6</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ pass 6</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ fail 0</span></div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">=== git history ===</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">d57f48c ci: delivery pipeline — pre-commit gate, GitHub Actions, deploy script</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">b61bb3c ops: supervised lifecycle — start/stop/status/health/backup + systemd unit</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">6090a4c feat: TinyType v0.1 — typing trainer API + UI + tests</span></div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">=== tree ===</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">backups/</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">deploy/</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">.githooks/</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">.github/workflows/</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">.gitignore</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">logs/</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">package.json</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">package-lock.json</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">public/</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">README.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">scripts/</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">server.js</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">src/</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">test/</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">.write-test</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="=== service ===process: RUNNING (pid 33660)health: OK -> {"status":"ok","uptimeSec":107}=== tests ===ℹ tests 6ℹ pass 6ℹ fail 0=== git history ===d57f48c ci: delivery pipeline — pre-commit gate, GitHub Actions, deploy scriptb61bb3c ops: supervised lifecycle — start/stop/status/health/backup + systemd unit6090a4c feat: TinyType v0.1 — typing trainer API + UI + tests=== tree ===backups/deploy/.githooks/.github/workflows/.gitignorelogs/package.jsonpackage-lock.jsonpublic/README.mdscripts/server.jssrc/test/.write-test"><div></div></button></div></figure></div> <p>Good hygiene check — and I can see my own housekeeping mistakes: <code dir="auto">.write-test</code>, <code dir="auto">logs/tinytype.pid</code>, and <code dir="auto">backups/*.db</code> got committed because <code dir="auto">.gitignore</code> only covered <code dir="auto">data/</code>. A DevOps-minded repo keeps runtime artifacts out of git. Fixing:</p> <p><strong><code dir="auto">bash</code></strong> — `cd ~/dev/tinytype && git ls-files | grep -E “logs|backups|write-test” && rm -f .write-test && printf ‘node_modules/\ndata/\n*.log\nlogs/\nbackups/\n’ > .gitignore && git rm -r –cached -q logs backups</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">.write-test</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">backups/tinytype-20260919-114624.db</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">logs/tinytype.pid</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">▶ pre-commit gate: npm test</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">✔ health endpoint answers ok from a real DB (43.306736ms)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">✔ text endpoint returns a passage with a word count (3.276776ms)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">✔ saving a result then listing it round-trips (19.327515ms)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">✔ results list respects the limit and caps at 100 (3.914424ms)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">✔ invalid results are rejected with 400 — server does not trust clients (19.883281ms)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">✔ unit: wordCount splits on whitespace (0.313911ms)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ tests 6</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ suites 0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ pass 6</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ fail 0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ cancelled 0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ skipped 0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ todo 0</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">ℹ duration_ms 219.535</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">▶ gate passed</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">---</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">db447aa chore: keep runtime artifacts out of version control</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">d57f48c ci: delivery pipeline — pre-commit gate</span></div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">…[truncated]</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code=".write-testbackups/tinytype-20260919-114624.dblogs/tinytype.pid▶ pre-commit gate: npm test✔ health endpoint answers ok from a real DB (43.306736ms)✔ text endpoint returns a passage with a word count (3.276776ms)✔ saving a result then listing it round-trips (19.327515ms)✔ results list respects the limit and caps at 100 (3.914424ms)✔ invalid results are rejected with 400 — server does not trust clients (19.883281ms)✔ unit: wordCount splits on whitespace (0.313911ms)ℹ tests 6ℹ suites 0ℹ pass 6ℹ fail 0ℹ cancelled 0ℹ skipped 0ℹ todo 0ℹ duration_ms 219.535▶ gate passed---db447aa chore: keep runtime artifacts out of version controld57f48c ci: delivery pipeline — pre-commit gate…[truncated]"><div></div></button></div></figure></div> <p>Everything is verified and the repo is clean — the gate even ran itself on the cleanup commit. Closing out the sprint:</p> <p><strong><code dir="auto">todowrite</code></strong> — `{“todos”: [{“content”: “Check env: npm registry access, ~/dev writable, node:sqlite available”, “priority”: “high”, “status”: “completed”}, {“content”: “Sprint 0: write Agile & Scrum methodology doc (</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">[</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">{</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">"content": "Check env: npm registry access, ~/dev writable, node:sqlite available",</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">"status": "completed",</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">"priority": "high"</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">},</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">{</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">"content": "Sprint 0: write Agile & Scrum methodology doc (what it is, why, ceremonies)",</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">"status": "completed",</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">"priority": "high"</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">},</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">{</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">"content": "DEV: scaffold TinyType repo (package.json, server.js, db.js, UI)",</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">"status": "completed",</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">"priority": "high"</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">},</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">{</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">"content": "DEV: write + run tests (API + unit) using node:test",</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">"status": "completed",</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">"priority": "high"</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">},</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">{</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">"content": "OPS: run service with start/stop/status scripts, health checks, logging, backup",</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">"status": "completed",</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">"priority": "high"</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">},</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">{</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">"content": "DEVOPS: g</span></div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">…[truncated]</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="[ { "content": "Check env: npm registry access, ~/dev writable, node:sqlite available", "status": "completed", "priority": "high" }, { "content": "Sprint 0: write Agile & Scrum methodology doc (what it is, why, ceremonies)", "status": "completed", "priority": "high" }, { "content": "DEV: scaffold TinyType repo (package.json, server.js, db.js, UI)", "status": "completed", "priority": "high" }, { "content": "DEV: write + run tests (API + unit) using node:test", "status": "completed", "priority": "high" }, { "content": "OPS: run service with start/stop/status scripts, health checks, logging, backup", "status": "completed", "priority": "high" }, { "content": "DEVOPS: g…[truncated]"><div></div></button></div></figure></div> <p>Sprint finished — every DoD item done, all hats documented. Here’s the whole thing in one view:</p> <div class="sl-heading-wrapper level-h2"><h2 id="-the-devops-playground--sprint-complete">🏁 The DevOps Playground — Sprint complete</h2><a class="sl-anchor-link" href="#-the-devops-playground--sprint-complete"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore>Section titled “🏁 The DevOps Playground — Sprint complete”</span></a></div> <p><strong>What got built:</strong> <strong>TinyType</strong>, a mini-monkeytype typing trainer (it’s on your to-do list, and it pairs with your [[Touch Typing]] note). Node 24 + Express 5 + built-in SQLite + zero build step. <strong>Live now at <a href="http://127.0.0.1:3417">http://127.0.0.1:3417</a></strong> (also in [[Local Services]]).</p> <p><strong>The three hats, played and documented separately — with how <em>and</em> why:</strong></p> <table> <thead> <tr> <th>Hat</th> <th>Delivered</th> <th>The key <em>why</em></th> </tr> </thead> <tbody> <tr> <td>🧑💻 <strong>Developer</strong> · [[1 - Role Developer]]</td> <td>API + UI + 6/6 tests green</td> <td><code dir="auto">node:sqlite</code> (zero native deps), node:test (zero config), no build step (fewer parts = fewer breaks), server-side validation (clients lie), WAL mode (the <em>operator-friendly</em> choice — that’s DevOps thinking in code)</td> </tr> <tr> <td>🛠️ <strong>Operator</strong> · [[2 - Role Operator]]</td> <td>start/stop/status/health/backup scripts + systemd unit</td> <td>Probe the <strong>endpoint</strong> not the process; SIGTERM before SIGKILL; <code dir="auto">sqlite3 .backup</code> not <code dir="auto">cp</code> (WAL gotcha); <strong>backup proven by restore</strong> (2/2 rows)</td> </tr> <tr> <td>🔗 <strong>DevOps</strong> · [[3 - Role DevOps]]</td> <td>4-phase commit spine, pre-commit gate, GitHub Actions, deploy.sh</td> <td>Shift-left (block the bug before it exists), <code dir="auto">npm ci</code> (reproducible), deploy = <strong>test → pull → install → restart → verify</strong></td> </tr> </tbody> </table> <p><strong>The methodology</strong> · [[0 - Agile & Scrum]]: Agile exists because waterfall delivered surprises after months; Scrum is 3 roles + 3 artifacts + 5 ceremonies creating <em>inspect → adapt</em> loops. We ran one real sprint — backlog, DoD, standups (including a real blocker: no systemd in the sandbox), review, and an honest [[DevOps Playground|retrospective]].</p> <p><strong>The two moments that made it real (not theory):</strong></p> <ol> <li>I deliberately broke the health endpoint (<code dir="auto">ok</code>→<code dir="auto">oops</code>) — the <strong>pre-commit gate blocked the commit</strong>. Broken code never landed.</li> <li>Then I made a genuine mistake recovering from it (<code dir="auto">git checkout --</code> restored from the index, not HEAD) — it became a documented lesson instead of being scrubbed. The retro keeps it honest.</li> </ol> <p><strong>How to keep going</strong> (from the retro): connect to GitHub and watch CI go green → red; drill the recovery scenario (<code dir="auto">rm data/*</code>, restore, prove it); swap the scripts for systemd on the host; or open the app and actually train a few WPM — your results persist in SQLite.</p> <p><strong>Read it in order:</strong> [[DevOps Playground]] → [[0 - Agile & Scrum]] → [[1 - Role Developer]] → [[2 - Role Operator]] → [[3 - Role DevOps]].</p> <p>is the app running right now ?</p> <p><strong><code dir="auto">bash</code></strong> — <code dir="auto">cd ~/dev/tinytype && ./scripts/status.sh; echo "---"; curl -s -o /dev/null -w "HTTP %{http_code}\n" http://127.0.0.1:3417/ ; cat logs/tinytype.pid 2>/dev/null && echo " (pid)"</code></p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">process: RUNNING (pid 33660)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">health: OK -> {"status":"ok","uptimeSec":142}</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">---</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">HTTP 200</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">33660</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#d6deeb;--1:#403f53"> </span></span><span style="--0:#d6deeb;--1:#403f53">(pid)</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="process: RUNNING (pid 33660)health: OK -> {"status":"ok","uptimeSec":142}---HTTP 20033660 (pid)"><div></div></button></div></figure></div> <p>Yes — it’s alive and healthy right now:</p> <ul> <li><strong>Process</strong>: RUNNING (pid 33660)</li> <li><strong>Health check</strong>: <code dir="auto">{"status":"ok","uptimeSec":142}</code> — the DB-backed probe answers, not just the process</li> <li><strong>Front page</strong>: HTTP 200 on <a href="http://127.0.0.1:3417/">http://127.0.0.1:3417/</a></li> </ul> <p>That’s the operator’s own tool answering ([[2 - Role Operator|scripts/status.sh]]) — the same probe the deploy pipeline uses as its final step. Open <a href="http://127.0.0.1:3417/">http://127.0.0.1:3417/</a> and you can type a run; it saves to SQLite and shows your last 20 results.</p> <p>while we’re at it let’s also explain the deveopment process of a deveoper for a wanna be developer to learn and understand from it</p> <p>Good idea — the Playground shows what each <em>role</em> does, but the day-in-day-out <strong>craft of writing software</strong> deserves its own note. A wannabe developer mostly needs to understand: <em>what am I actually doing all day, in what order, and what’s the mental model?</em> Let me write it as a companion to the Developer role doc, using the TinyType sprint we just lived as the worked example:</p> <p><strong><code dir="auto">write</code></strong> — `{“content”: “# 1b - The Developer Process\n\n> Part of the [[DevOps Playground]]. The <strong>craft</strong> behind the [[1 - Role Developer|Developer hat]] — what a developer actually <em>does</em>, minute by minute, da</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p>Now wiring it into the series so it’s part of the reading flow:</p> <p><strong><code dir="auto">edit</code></strong> — `{“filePath”: “/home/sambasene/obsidian/Vault/Learn/DevOps/DevOps Playground/DevOps Playground.md”, “newString”: “1. <strong>[[0 - Agile & Scrum]]</strong> — the methodology: what Agile/Scrum are, <em>why</em> they exist,</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Edit applied successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Edit applied successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">edit</code></strong> — `{“filePath”: “/home/sambasene/obsidian/Vault/Learn/DevOps/DevOps Playground/DevOps Playground.md”, “newString”: “### Related\n- [[0 - Agile & Scrum]] · [[1 - Role Developer]] · [[1b - The Developer Pr</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Edit applied successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Edit applied successfully."><div></div></button></div></figure></div> <p><strong><code dir="auto">edit</code></strong> — `{“filePath”: “/home/sambasene/obsidian/Vault/Learn/DevOps/DevOps Playground/1 - Role Developer.md”, “newString”: “<em>Next:</em> [[1b - The Developer Process]] — how a developer actually <em>works</em>, loop by loo</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Edit applied successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Edit applied successfully."><div></div></button></div></figure></div> <p>Done — <strong>[[1b - The Developer Process]]</strong> is written and wired into the series (read order in the [[DevOps Playground|index]] is now 0 → 1 → <strong>1b</strong> → 2 → 3).</p> <p>What it teaches a wannabe developer — the short version:</p> <p><strong>The core mental model:</strong> development is a loop — <em>think → change → run → verify</em> — repeated thousands of times in small steps, without lying to yourself about what works. Two goals govern everything: <strong>shrink the loop</strong> and <strong>keep the loop honest</strong>.</p> <p><strong>The lifecycle, with real TinyType receipts</strong> (every phase references something we actually did):</p> <ol> <li><strong>Understand before you type</strong> — ask questions, write acceptance criteria, pick a stack as a defended trade-off (never fashion)</li> <li><strong>Reproducible environment</strong> — <code dir="auto">npm ci && npm start</code> on a fresh machine = the Dev↔DevOps handshake</li> <li><strong>The inner loop</strong> — tiny slices, verify with <code dir="auto">curl</code>, never assume</li> <li><strong>Read the error</strong> — the #1 skill; includes our real <code dir="auto">MODULE_NOT_FOUND</code> fix and the <code dir="auto">git checkout</code> vs <code dir="auto">git restore</code> mistake as lived lessons</li> <li><strong>Git habits</strong> — coherent commits, messages for future-you, never commit data/secrets</li> <li><strong>Tests as safety net + living documentation</strong> — the pyramid, and <em>coverage ≠ quality</em></li> <li><strong>The stuck protocol</strong> — 25-minute timebox, shrink the problem, walk away (the shower effect is real)</li> <li><strong>Finishing + handoff</strong> — DoD checklist, why-comments, honest README, then watch your commit travel through CI to a running process</li> </ol> <p>Plus: a <strong>day-in-the-life timeline</strong>, a <strong>10-habit cheat sheet</strong>, the <strong>5 beginner failure modes and their cures</strong>, and Kernighan’s law — <em>“if you write the code as cleverly as possible, you are by definition not smart enough to debug it”</em> — which is the single most useful sentence in software engineering.</p> <p>Want me to make it a printable one-page cheat sheet, or a French version, or should we now start <strong>sprint 2</strong> (the retro’s “try next” list has GitHub CI turn red-green and a backup recovery drill ready to go)?</p> <p>in one bilangual documentation file document the experiment i just did with the roles and processes and explanations</p> <p>Bilingual it is — one consolidated file covering the whole experiment. Let me first check the <code dir="auto">Documentation/Projects/</code> conventions used in this vault:</p> <p><strong><code dir="auto">bash</code></strong> — <code dir="auto">ls "/home/sambasene/obsidian/Vault/Documentation/" 2>/dev/null; echo "---"; ls "/home/sambasene/obsidian/Vault/Documentation/Projects/" 2>/dev/null | head -30</code></p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">2026</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Documentation.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">GOAT Timetable</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Projects</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">---</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Asterisk</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">DartPad - Setup Guide.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">DartPad Setup Report.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Docs Sites - Public & Private.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">FreePBX</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Hermes Agent - Setup.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Hermes Agent Setup Report.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Jitsi</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Linux Journey - Setup.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Linux Journey Setup Report.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Matrix + Element - Setup.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Matrix + Element Setup Report.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">OpenClaw Fedora - Setup.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">OpenClaw Fedora Setup Report.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">PeerTube - Config + Details.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">PeerTube - Setup.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">PeerTube Setup Report.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Rapport DartPad Setup.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Rapport Hermes Agent Setup.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Rapport Linux Journey Setup.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Rapport Matrix + Element Setup.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Rapport OpenClaw Fedora Setup.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Rapport PeerTube Setup.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Rapport RocketChat Setup.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Rapport Strapi Setup.md</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Rapport Va</span></div></div><div class="ec-line"><div class="code"> </div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">…[truncated]</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="2026Documentation.mdGOAT TimetableProjects---AsteriskDartPad - Setup Guide.mdDartPad Setup Report.mdDocs Sites - Public & Private.mdFreePBXHermes Agent - Setup.mdHermes Agent Setup Report.mdJitsiLinux Journey - Setup.mdLinux Journey Setup Report.mdMatrix + Element - Setup.mdMatrix + Element Setup Report.mdOpenClaw Fedora - Setup.mdOpenClaw Fedora Setup Report.mdPeerTube - Config + Details.mdPeerTube - Setup.mdPeerTube Setup Report.mdRapport DartPad Setup.mdRapport Hermes Agent Setup.mdRapport Linux Journey Setup.mdRapport Matrix + Element Setup.mdRapport OpenClaw Fedora Setup.mdRapport PeerTube Setup.mdRapport RocketChat Setup.mdRapport Strapi Setup.mdRapport Va…[truncated]"><div></div></button></div></figure></div> <p>Conventions confirmed (EN report + <code dir="auto">Rapport ...</code> for FR). Since you want <strong>one</strong> file, I’ll put it in <code dir="auto">Documentation/Projects/</code> with both languages mirrored inside — first-person voice, real outputs preserved as-is, code/commands identical in both languages:</p> <p><strong><code dir="auto">write</code></strong> — `{“content”: “# DevOps Playground — Bilingual Report (FR / EN)\n\n<strong>Projet / Project:</strong> DevOps Playground — l’expérience "apprendre DevOps en faisant" / the "learn DevOps by doing" experiment\n**Da</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Wrote file successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Wrote file successfully."><div></div></button></div></figure></div> <p>Now let me make it discoverable from the Playground index:</p> <p><strong><code dir="auto">edit</code></strong> — `{“filePath”: “/home/sambasene/obsidian/Vault/Learn/DevOps/DevOps Playground/DevOps Playground.md”, “newString”: “### Related\n- 📄 <strong>[[DevOps Playground - Bilingual Report (FR-EN)]]</strong> — the whole exper</p> <p>…[truncated]`</p> <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Edit applied successfully.</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="Edit applied successfully."><div></div></button></div></figure></div> <p>Done — <strong>[[DevOps Playground - Bilingual Report (FR-EN)]]</strong> is in <code dir="auto">Documentation/Projects/</code> (the vault’s report home, following the same naming conventions as your other reports).</p> <p><strong>One file, two complete mirrors:</strong></p> <p>📄 <strong>Partie 1 — Français</strong> → <strong>Part 2 — English</strong></p> <p>Each contains the full experiment:</p> <ol> <li><strong>Pourquoi / Why</strong> — the “learn by doing, three hats” idea</li> <li><strong>La méthodologie / Methodology</strong> — Agile & Scrum: what it is, why it exists (waterfall problem, empiricism, the ceremonies), how it was applied (one real sprint)</li> <li><strong>Les trois rôles / The three roles</strong> — for each: what the role is, the process followed, and a decisions table with the <em>why</em> (SIGTERM, <code dir="auto">.backup</code> not <code dir="auto">cp</code>, probe don’t assume, shift-left gate…)</li> <li><strong>Le processus de développement / The development process</strong> — the think→change→run→verify loop, the 3 loops, the stuck protocol, Kernighan’s law</li> <li><strong>Journal du sprint / Sprint journal</strong> — real ceremonies and outcomes (Review with receipts, Retrospective)</li> <li><strong>Artefacts & état final / Artifacts & final state</strong> — commit log, status table, replay commands</li> <li><strong>Mistakes / leçons</strong> — kept visible, per your usual requirement</li> </ol> <p><strong>Conventions respected</strong> (from the vault’s local-setup protocol): first-person voice throughout, <strong>code blocks / commands / real outputs byte-identical in both languages</strong>, only prose translated, and it’s linked from the [[DevOps Playground]] index so both reading paths find it.</p> <p><em>39 internal reasoning block(s) omitted — raw thinking is not exported (see archive index).</em></p> </div><footer class="sl-flex astro-ddtxxk7k"><div class="meta sl-flex astro-ddtxxk7k"></div><div class="pagination-links print:hidden astro-b5raizh3" dir="ltr"><a href="/archive/obsidian/54-shutdown-prep-list-local-processes/" rel="prev" class="astro-b5raizh3"><svg aria-hidden="true" class="astro-b5raizh3 astro-hkc32dio" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.5rem;"><path d="M17 11H9.41l3.3-3.29a1.004 1.004 0 1 0-1.42-1.42l-5 5a1 1 0 0 0-.21.33 1 1 0 0 0 0 .76 1 1 0 0 0 .21.33l5 5a1.002 1.002 0 0 0 1.639-.325 1 1 0 0 0-.219-1.095L9.41 13H17a1 1 0 0 0 0-2Z"/></svg><span class="astro-b5raizh3">Previous<br class="astro-b5raizh3"><span class="link-title astro-b5raizh3">Shutdown prep: list local processes</span></span></a><a href="/archive/obsidian/zz-collapsed/" rel="next" class="astro-b5raizh3"><svg aria-hidden="true" class="astro-b5raizh3 astro-hkc32dio" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.5rem;"><path d="M17.92 11.62a1.001 1.001 0 0 0-.21-.33l-5-5a1.003 1.003 0 1 0-1.42 1.42l3.3 3.29H7a1 1 0 0 0 0 2h7.59l-3.3 3.29a1.002 1.002 0 0 0 .325 1.639 1 1 0 0 0 1.095-.219l5-5a1 1 0 0 0 .21-.33 1 1 0 0 0 0-.76Z"/></svg><span class="astro-b5raizh3">Next<br class="astro-b5raizh3"><span class="link-title astro-b5raizh3">Obsidian sessions — collapsed sessions</span></span></a></div></footer></div></div></main></div></div></div></div></body></html>