dorfl 0.3.1 → 0.4.0

package/dist/advance-drivers.d.ts

@@ -67,7 +67,7 @@ export interface PerformAdvanceMultiOptions extends SharedAdvanceContext {
     /**
      * The per-machine {@link ConfigOverrideMap}. Threaded into the in-place pool
      * scan (`scanRepoPaths`) so the per-machine override applies to advance
-     * autopick eligibility — WITHOUT it the committed `.dorfl.json` silently
+     * autopick eligibility — WITHOUT it the committed `dorfl.json` silently
      * beats the override on this path (the in-place advance autopick mirror of the
      * `do` autopick defect).
      */

package/dist/advance-lifecycle-template.js

@@ -166,7 +166,7 @@ on:
       # Override an engine gate for THIS manual run only, riding the env layer of
       # flag > env > per-repo > global > default. Modelled as \`type: choice\` with a
       # BLANK first option (not \`type: boolean\`, which cannot represent "unset"):
-      # blank ⇒ emit NOTHING (the committed .dorfl.json wins, today's
+      # blank ⇒ emit NOTHING (the committed dorfl.json wins, today's
       # behaviour); a non-blank choice ⇒ export the matching DORFL_* for this
       # run. The blank is load-bearing: env-config coercion THROWS on an empty
       # string, so the per-job step below only writes when the input is non-blank.
@@ -237,11 +237,11 @@ env:
   # ── The engine GATE FAMILY is resolved FROM CONFIG, not carried here ─────────
   # CI is NOT a special policy surface (ADR ci-config-policy-and-gate-family §5):
   # it runs the SAME engine gates, resolved through flag > env > per-repo > global
-  # > default. The SAME .dorfl.json the laptop uses applies here. This
+  # > default. The SAME dorfl.json the laptop uses applies here. This
   # workflow emits NO DORFL_AUTO_BUILD / DORFL_AUTO_TASK /
   # DORFL_OBSERVATION_TRIAGE / DORFL_SURFACE_BLOCKERS line on a
   # SCHEDULE/PUSH tick, so the env layer carries NO defaults there — your committed
-  # .dorfl.json wins (then the global config, then the strict built-in
+  # dorfl.json wins (then the global config, then the strict built-in
   # defaults autoBuild:false / autoTask:false / observationTriage:'off' /
   # surfaceBlockers:false). The ONE exception is a manual \`workflow_dispatch\` where
   # you fill a gate override input (above): the per-job step then exports that ONE
@@ -250,7 +250,7 @@ env:
   # \`enumerate\` scan (it gates the matrix pools via observationTriage/surfaceBlockers
   # /autoTask/autoBuild), not just the agent-running jobs — or the override is inert
   # for the very pools it targets. To enable CI autonomy durably, set the gate(s) in
-  # .dorfl.json (applies everywhere) — NOT by re-running install-ci (ADR §6:
+  # dorfl.json (applies everywhere) — NOT by re-running install-ci (ADR §6:
   # install-ci is one-time).
 
 jobs:
@@ -467,7 +467,7 @@ jobs:
       - name: advance one item in-place (merge ⇒ rebase + CAS land on main)
         # In-place (no --isolated/--remote). \`--merge\` ties the integration mode
         # to THIS (matrix) shape: it sits at the top of the precedence chain, so
-        # the workflow mode always wins over the repo's \`.dorfl.json\` default.
+        # the workflow mode always wins over the repo's \`dorfl.json\` default.
         # Cross-job land safety comes from the engine's CAS-retry loop, not from
         # this workflow's job shape. \`gh\` (merge / PR housekeeping) reads
         # \`GH_TOKEN\` from the env.
@@ -580,7 +580,7 @@ export function validateAdvanceLifecycleWorkflow(text) {
     // The workflow emits NO active gate env line for any of AUTO_BUILD / AUTO_TASK
     // / OBSERVATION_TRIAGE / SURFACE_BLOCKERS: the env layer is the OPTIONAL CI-only
     // override layer, NOT the carrier of defaults. Emitting any of them would FORCE
-    // env to win over the repo's own .dorfl.json (the precedence is
+    // env to win over the repo's own dorfl.json (the precedence is
     // flag > env > per-repo > global > default), silently shadowing per-repo gate
     // config in CI — exactly the bug this task closes. A user who genuinely wants a
     // CI-SPECIFIC override adds the env var themselves (the opt-in CI override the

package/dist/advance-lifecycle-template.js.map

@@ -1 +1 @@
-{"version":3,"file":"advance-lifecycle-template.js","sourceRoot":"","sources":["../src/advance-lifecycle-template.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"advance-lifecycle-template.js","sourceRoot":"","sources":["../src/advance-lifecycle-template.ts"],"names":[],"mappings":"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"}

package/dist/brand.d.ts

@@ -8,7 +8,7 @@
  *
  *   - the `DORFL_` env-var prefix (a missed one is read as "unset" — the
  *     worst kind of failure: silent);
- *   - the `.dorfl.json` per-repo config filename;
+ *   - the `dorfl.json` per-repo config filename;
  *   - the `~/.dorfl/` workspaces-dir default + the `dorfl` config
  *     dir name;
  *   - the `.dorfl-job.json` per-job record filename;

package/dist/brand.js

@@ -8,7 +8,7 @@
  *
  *   - the `DORFL_` env-var prefix (a missed one is read as "unset" — the
  *     worst kind of failure: silent);
- *   - the `.dorfl.json` per-repo config filename;
+ *   - the `dorfl.json` per-repo config filename;
  *   - the `~/.dorfl/` workspaces-dir default + the `dorfl` config
  *     dir name;
  *   - the `.dorfl-job.json` per-job record filename;

package/dist/cli.d.ts

@@ -1,6 +1,15 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
+import { type ResyncResult } from './resync-protocol.js';
 import { type InstallSkillsResult } from './install-skills.js';
+/**
+ * Human-readable report for the deterministic protocol re-sync half of
+ * `dorfl sync`. Groups the docs into changed / unchanged / skipped and names the
+ * VERSION file. `dryRun` reframes it as "WOULD" so a preview reads honestly.
+ * A SKIPPED doc (unresolvable source) is surfaced LOUDLY — the contract in the
+ * target repo is incomplete for that doc.
+ */
+export declare function formatSyncReport(result: ResyncResult, dryRun: boolean): string;
 export declare function buildProgram(): Command;
 /**
  * Human-readable report for `dorfl skills add`. Prints the SOURCE the skills

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAC,OAAO,EAAS,MAAM,WAAW,CAAC;AAyJ1C,OAAO,EAAgB,KAAK,mBAAmB,EAAC,MAAM,qBAAqB,CAAC;AAihC5E,wBAAgB,YAAY,IAAI,OAAO,CA+yGtC;AAaD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE,OAAO,GACZ,MAAM,CAyBR;AA+FD;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzE"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAC,OAAO,EAAS,MAAM,WAAW,CAAC;AAmH1C,OAAO,EAAiB,KAAK,YAAY,EAAC,MAAM,sBAAsB,CAAC;AAuCvE,OAAO,EAAgB,KAAK,mBAAmB,EAAC,MAAM,qBAAqB,CAAC;AA2xB5E;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,OAAO,GACb,MAAM,CAoCR;AA6RD,wBAAgB,YAAY,IAAI,OAAO,CAs3GtC;AAaD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE,OAAO,GACZ,MAAM,CAyBR;AA+FD;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzE"}

package/dist/cli.js

@@ -46,6 +46,7 @@ import { renderPrompt } from './prompt.js';
 import { resolvePromptGuidance } from './config.js';
 import { gc, RETAIN_REASON_TEXT } from './gc.js';
 import { runPrdToSpec, } from './prd-to-spec.js';
+import { resyncProtocol } from './resync-protocol.js';
 import { sweepRemoteMergedBranches } from './reap-branches.js';
 import { sweepOrphanSidecars } from './orphan-sidecar.js';
 import { sweepLedgerDuplicates, formatLedgerSweep } from './ledger-lint.js';
@@ -123,7 +124,7 @@ function loadGlobalAndOverride(configPath) {
 }
 /**
  * Resolve the effective config for a `do --remote <r>` run, layering the target
- * repo's COMMITTED `.dorfl.json` (read from `<arbiter>/main` via the hub
+ * repo's COMMITTED `dorfl.json` (read from `<arbiter>/main` via the hub
  * mirror) into the SAME `flag > env > per-repo > global > default` chain in-place
  * `do` uses. This is the no-checkout analogue of {@link resolveRepoConfig}: there
  * is no working tree, so the bytes come from the arbiter's `main` instead of the
@@ -138,7 +139,7 @@ function loadGlobalAndOverride(configPath) {
  * the arbiter was momentarily offline.
  *
  * The config read uses {@link ensureMirrorMain} (main-only, NO-prune), NOT the
- * all-heads pruning {@link ensureMirror}: `git show main:.dorfl.json` only
+ * all-heads pruning {@link ensureMirror}: `git show main:dorfl.json` only
  * needs `main`, and the all-heads `+refs/heads/*:refs/heads/*` fetch would let a
  * `work/<slug>` branch CHECKED OUT in some stale job worktree block it (git
  * refuses to fetch into a checked-out branch), throwing the read into its
@@ -343,7 +344,7 @@ function resolveDefaultArbiterForCwd(cwd, global, flags, override) {
     // The SAME per-repo config read in-place `do` uses (`resolveRepoConfig` on the
     // cwd), so `--isolated` resolves the arbiter remote NAME (`defaultArbiter`)
     // through the identical `flag > env > per-repo > global > default` chain. An
-    // absent `.dorfl.json` falls back to the global/default (`origin`).
+    // absent `dorfl.json` falls back to the global/default (`origin`).
     return resolveRepoConfig({ repoPath: cwd, global, flags, override }).config
         .defaultArbiter;
 }
@@ -512,6 +513,60 @@ function printPrdToSpecReport(result) {
 function printLeak(leak) {
     console.error(`  [${leak.lens}] ${leak.where}: '${leak.token}' — ${leak.why}`);
 }
+/**
+ * A minimal interactive yes/no confirmation (default NO). Prompts on stderr
+ * (stdout stays reserved for machine/report output) and reads one line from
+ * stdin. Callers only reach this on an interactive (TTY) session — a non-TTY
+ * path decides WITHOUT prompting (so a scripted run never hangs). Returns true
+ * only for an explicit `y`/`yes`.
+ */
+function confirmYesNo(message) {
+    return new Promise((resolvePrompt) => {
+        const rl = createInterface({ input: process.stdin, output: process.stderr });
+        rl.question(`${message} [y/N] `, (answer) => {
+            rl.close();
+            const a = answer.trim().toLowerCase();
+            resolvePrompt(a === 'y' || a === 'yes');
+        });
+    });
+}
+/**
+ * Human-readable report for the deterministic protocol re-sync half of
+ * `dorfl sync`. Groups the docs into changed / unchanged / skipped and names the
+ * VERSION file. `dryRun` reframes it as "WOULD" so a preview reads honestly.
+ * A SKIPPED doc (unresolvable source) is surfaced LOUDLY — the contract in the
+ * target repo is incomplete for that doc.
+ */
+export function formatSyncReport(result, dryRun) {
+    const lines = [];
+    const changed = result.docs.filter((d) => !d.unchanged && !d.skipped);
+    const unchanged = result.docs.filter((d) => d.unchanged);
+    const skipped = result.docs.filter((d) => d.skipped);
+    const verb = dryRun ? 'WOULD sync' : 'Synced';
+    lines.push(dryRun
+        ? '=== dorfl sync (DRY RUN — nothing written) ==='
+        : '=== dorfl sync ===');
+    lines.push(`Protocol: ${verb} ${result.docs.length} doc(s) — ` +
+        `${changed.length} changed, ${unchanged.length} unchanged, ` +
+        `${skipped.length} skipped.`);
+    for (const d of changed) {
+        lines.push(`  ~ ${d.dest}`);
+    }
+    for (const d of skipped) {
+        lines.push(`  !! ${d.name}: SOURCE could not be resolved — NOT copied ` +
+            '(the contract doc is missing in the package).');
+    }
+    if (changed.length > 0 || skipped.length === result.docs.length) {
+        lines.push(`VERSION: ${dryRun ? 'WOULD bump' : 'bumped'} ${result.versionPath}` +
+            (skipped.length === result.docs.length
+                ? ' (no doc synced — no bump)'
+                : '.'));
+    }
+    else {
+        lines.push(`VERSION: unchanged (${result.versionPath} — already current).`);
+    }
+    return lines.join('\n');
+}
 /**
  * Resolve a task-only command's slug argument through the §3a namespace guard
  * (`resolveTaskOnlyArg`): accept bare (= task) + `task:` (explicit alias),
@@ -1142,7 +1197,7 @@ export function buildProgram() {
         const slug = resolveTaskOnlySlug(rawSlug);
         // Resolve the `promptGuidance` NUDGE namespace through the SAME chain the
         // gate family uses (env > per-repo > global > default), so e.g. a
-        // `promptGuidance.testFirst:true` in `.dorfl.json` strengthens the
+        // `promptGuidance.testFirst:true` in `dorfl.json` strengthens the
         // wrapper line for `dorfl prompt` exactly as it would in `do`/`run`.
         const cwd = process.cwd();
         const global = loadConfig();
@@ -1233,7 +1288,7 @@ export function buildProgram() {
             process.exit(recovered.exitCode);
         }
         // Resolve the integration mode at completion time, highest first:
-        //   --merge/--propose flag > per-repo .dorfl.json > global > default.
+        //   --merge/--propose flag > per-repo dorfl.json > global > default.
         // The flag sits at the TOP of the same chain the autonomous runner uses
         // (per-repo > global > default), so human and autonomous paths agree.
         const flagMode = integrationFromFlags(flags);
@@ -1381,7 +1436,7 @@ export function buildProgram() {
         const cwd = process.cwd();
         const { global, override } = loadGlobalAndOverride(flags.config);
         // Resolve the integration mode at integrate-time, highest first:
-        //   --merge/--propose flag > per-repo .dorfl.json > global > default.
+        //   --merge/--propose flag > per-repo dorfl.json > global > default.
         // (Same chain `complete` uses — `do` is the autonomous twin.)
         let flagMode;
         try {
@@ -1403,7 +1458,7 @@ export function buildProgram() {
         // ORTHOGONAL: `--isolated` + `--remote` is REDUNDANT (a foreign `--remote` is
         // already isolated), so we accept it and `--remote` WINS (see `## Decisions`).
         //
-        // In BOTH cases the repo's COMMITTED `.dorfl.json` is reachable on
+        // In BOTH cases the repo's COMMITTED `dorfl.json` is reachable on
         // `<arbiter>/main` (the mirror), so we layer it — `flag > env > per-repo >
         // global > default` parity with in-place `do` (task
         // `remote-do-reads-per-repo-config-from-arbiter-main`). Only the whitelisted
@@ -1508,7 +1563,7 @@ export function buildProgram() {
             // mirror fetch runs under). These are host-only by definition (rejected
             // per-repo), so reading them from global+flags first is correct and stable.
             const bootstrap = resolveGlobalConfig(global, remoteFlags);
-            // Source the committed `.dorfl.json` from `<arbiter>/main` via the
+            // Source the committed `dorfl.json` from `<arbiter>/main` via the
             // hub mirror, then layer ONLY its whitelisted keys through the EXISTING
             // per-repo machinery. The read refreshes ONLY `main` (no-prune), so a
             // `work/<slug>` branch checked out in a stale worktree can never block it,
@@ -1563,7 +1618,7 @@ export function buildProgram() {
                 // Single-job build path: gate the REBASED tip (the default) unconditionally.
                 freshWorktreeGate: remoteConfig.freshWorktreeGate,
                 // Cross-job merge-serialiser CAS-retry cap (resolved through the per-repo
-                // chain on the arbiter-side `.dorfl.json` too) — spec
+                // chain on the arbiter-side `dorfl.json` too) — spec
                 // `land-time-reverify-and-parallel-merge-ceiling` Story 5.
                 mergeRetries: remoteConfig.mergeRetries,
                 noPR: remoteConfig.noPR,
@@ -1894,7 +1949,7 @@ export function buildProgram() {
         const cwd = process.cwd();
         const { global, override } = loadGlobalAndOverride(flags.config);
         // Resolve the integration mode this invocation asks for, highest first:
-        //   --merge/--propose flag > per-repo .dorfl.json > global > default.
+        //   --merge/--propose flag > per-repo dorfl.json > global > default.
         // The SAME chain `do`/`complete` use (via `integrationFromFlags`), so the
         // human, the autonomous runner, and the CI workflow all resolve the SAME
         // order. This is what ties the CI dispatch `integrationMode` to the actual
@@ -1948,7 +2003,7 @@ export function buildProgram() {
                     `remote), or use --remote <url> to target another repo.`);
                 process.exit(1);
             }
-            // Source the arbiter's COMMITTED `.dorfl.json` from `<arbiter>/main`
+            // Source the arbiter's COMMITTED `dorfl.json` from `<arbiter>/main`
             // via the hub mirror + layer ONLY its whitelisted keys — the SAME
             // resolution `do --isolated` uses, so the gate family (autoBuild/autoTask/
             // observationTriage/surfaceBlockers) + selectionOrder + integration resolve
@@ -2460,6 +2515,59 @@ export function buildProgram() {
         }
         console.log(`Summary: ${result.reaped.length} reaped, ${result.retained.length} retained.`);
     });
+    // `dorfl sync`: bring an already-onboarded repo up to the CURRENT protocol.
+    // Always re-syncs `work/protocol/*` + bumps VERSION (the deterministic slice of
+    // `setup`, shared with `prd-to-spec` via `resync-protocol.ts`). `--add-skills`
+    // ADDITIONALLY (re-)installs the packaged skills into the operator's harness
+    // dir(s), NON-INTERACTIVELY (the flag IS the confirmation); without it an
+    // interactive session PROMPTS once and a non-TTY session skips skills.
+    program
+        .command('sync')
+        .helpGroup(HEADLINE_GROUP)
+        .description("Bring THIS repo up to the current dorfl protocol: re-sync work/protocol/* from the package's canonical contract docs and bump work/protocol/VERSION (idempotent — a no-op when already current). This is how a repo that adopted an older protocol picks up the latest. Optionally ALSO (re-)installs the packaged dorfl skills into your own harness: pass --add-skills to do it non-interactively (the flag bypasses the ask), otherwise an interactive run prompts once (a non-TTY run skips skills). Runs IN-PLACE (no git commit/push — the human commits the result).")
+        .option('--repo <dir>', 'the repo working-tree root to sync (default: cwd)')
+        .option('--dry-run', 'REPORT what the protocol re-sync WOULD change, touching nothing (no writes; skills are never installed under --dry-run)')
+        .option('--add-skills', 'ALSO (re-)install the packaged dorfl skills into your own harness dir(s), non-interactively. This flag IS the confirmation — it bypasses the interactive ask.')
+        .option('--local', 'with skills install: scope to <cwd>/.agents/skills/ instead of the global ~/.agents/skills/ default')
+        .option('--json', 'output the raw protocol re-sync result as JSON')
+        .action(async (flags) => {
+        const repoPath = flags.repo ?? process.cwd();
+        const dryRun = flags.dryRun === true;
+        // 1. The deterministic protocol re-sync (always runs).
+        const resync = resyncProtocol(repoPath, {
+            dryRun,
+            sourceCommit: 'dorfl sync',
+        });
+        if (flags.json) {
+            console.log(JSON.stringify(resync, null, 2));
+        }
+        else {
+            console.log(formatSyncReport(resync, dryRun));
+        }
+        // A doc whose source could not be resolved is a broken package — exit
+        // non-zero so a scripted `sync` notices the incomplete contract.
+        const anySkipped = resync.docs.some((d) => d.skipped);
+        // 2. The OPTIONAL skills install. Never under --dry-run (a preview writes
+        //    nothing). `--add-skills` authorises it directly (bypasses the ask);
+        //    otherwise an interactive TTY prompts once, and a non-TTY skips.
+        if (!dryRun) {
+            let doSkills = flags.addSkills === true;
+            if (!doSkills && process.stdin.isTTY) {
+                const scope = flags.local === true ? 'project-local' : 'global';
+                doSkills = await confirmYesNo(`Also (re-)install the packaged dorfl skills into your ${scope} harness dir(s)?`);
+            }
+            if (doSkills) {
+                const result = installSkills({ global: flags.local !== true });
+                console.log(formatSkillsAddReport(result, flags.local === true));
+            }
+            else if (flags.addSkills !== true && !process.stdin.isTTY) {
+                console.error('>> Skills not installed (non-interactive run; pass --add-skills to install them).');
+            }
+        }
+        if (anySkipped) {
+            process.exit(1);
+        }
+    });
     program
         .command('prd-to-spec')
         .helpGroup(ADVANCED_GROUP)