mikoshi-construct 0.2.0 → 0.3.1

package/README.md

@@ -3,14 +3,18 @@
 Bootstrap for AI-native software projects. Start with a proven engineering workflow instead of an
 empty repository.
 
+**[Documentation](https://e1i.github.io/mikoshi-construct/)** · [Getting started](https://e1i.github.io/mikoshi-construct/guide/getting-started) · [The development cycle](https://e1i.github.io/mikoshi-construct/guide/the-cycle) · [CLI reference](https://e1i.github.io/mikoshi-construct/cli)
+
 ```bash
 mkdir my-service && cd my-service
 npx mikoshi-construct init          # interactive: preset, agent, project name
 pnpm install && pnpm run quality    # green before you write a line
 ```
 
-> **v0.1.** Presets `node-backend`, `node-frontend`, `node-library` and `monorepo`. Claude Code gets
+> **v0.3.** Presets `node-backend`, `node-frontend`, `node-library` and `monorepo`. Claude Code gets
 > the full lifecycle; Cursor gets the rules, the conventions and the discovery protocol.
+> `construct sync` moves a repository already carrying a construct onto newer templates.
+
 
 ## What it does
 
@@ -76,10 +80,14 @@ npx mikoshi-construct init --yes --preset node-frontend --ai both
 
 ```bash
 npx mikoshi-construct doctor     # baseline intact, harness intact, markers filled
+npx mikoshi-construct sync       # what newer templates would change; writes nothing
 npx mikoshi-construct soulkill   # what the detector sees; writes nothing
 npx mikoshi-construct cost --last
 ```
 
+`sync` reports and changes nothing until you ask for `--apply`, and even then it writes only what
+the construct itself wrote and you have not touched.
+
 Every command, flag and exit code: [docs/cli.md](https://github.com/E1i/mikoshi-construct/blob/main/docs/cli.md).
 
 ## Three principles
@@ -139,6 +147,7 @@ with a named check, not a second fix.
 |---|---|
 | `construct init` | Detect, configure, materialize. `--yes --preset node-backend\|node-frontend\|node-library\|monorepo --ai claude\|cursor\|both --review claude --dir . --dry-run` |
 | `construct doctor` | Baseline files present, harness intact, discovery markers filled — `GLITCH` by name when not |
+| `construct sync` | Classify every path against today's templates and report; `--apply` writes only what the construct owns and you have not changed (`--json`) |
 | `construct soulkill` | Print what the detector sees, write nothing (`--json`; aliases `inspect`, `capture`) |
 | `construct cost` | Token usage of the `/implement` runs in this directory, per agent, billable and price-weighted (`--last`, `--json`) |
 
@@ -176,6 +185,12 @@ The names are a tribute to Cyberpunk 2077 and mean exactly one thing each here.
 | Soulkiller | `construct soulkill`: extracts the facts about a repository and writes nothing |
 | Netrunner | The coding agent — Claude Code, Cursor — that connects to the project through the construct |
 | Relic | The files at the root the agent reads first: `AGENTS.md`, `CLAUDE.md`, `construct.json` |
+| Engram | The record `init` cut into `construct.json`: what the construct wrote, and the version that wrote it |
+| Braindance | `construct sync`: replaying that engram against today's templates and reporting where the two disagree |
+| Relic write | `construct sync --apply`: the one write into a repository the construct did not create |
+| Blackwall | Where a construct block whose template variant cannot be established sits — not yours, not ours, and nothing is written there |
+| Glitch | A warning in the output. Something wants a human; nothing has failed |
+| Flatlined | A check that failed outright: a missing baseline file, or no `construct.json` where one was required |
 | Harness | No lore. `pnpm run quality`. The one word that must be understood without this table |
 
 Not affiliated with CD Projekt Red.