@ai-substrate/engineering-harness 0.2.0

package/harness/cli/dist/services/record/core-types/retro.d.ts

@@ -0,0 +1,20 @@
+import type { HarnessRecordType } from '../contract.js';
+/**
+ * The core-bundled `retro` record type. Inline TS constant (plan Q-A "lean"):
+ * ships cleanly via `npx` with no `package.json#files`/packaging change, mirroring
+ * `services/scaffold/templates.ts`.
+ *
+ * `RETRO_TEMPLATE` is a **deployment echo** of the frozen
+ * `skills/eng-harness-loop/eng-harness-4-retro/references/retro.schema.json`: its
+ * frontmatter covers the schema's REQUIRED fields (`schema_version`, `retro_id`,
+ * `agent`, `started_at`) and uses only the schema's open `system` object. The
+ * schema stays the canonical contract; a future `schema?` field can attach it for
+ * opt-in validation without changing this type's shape. A unit test
+ * (`retro-template.test.ts`) pins the superset so the two can't drift.
+ *
+ * NOTE: `system.compound.*` below is a documented **convention** inside the
+ * schema's open `system` object — NOT a schema-defined field.
+ */
+export declare const RETRO_TEMPLATE = "---\nschema_version: \"1.0\"\nretro_id: \"<ISO8601Z>-<agent>-<hash>\"     # e.g. 2026-06-09T09:55:00Z-github-copilot-a8f3\nagent: \"<your-agent-slug>\"                 # lowercase kebab, e.g. github-copilot\nplan_id: \"<NNN-slug or null>\"\nstarted_at: \"<ISO8601Z>\"\nended_at: \"<ISO8601Z>\"\nsummary: \"<one paragraph: what happened this session>\"\nentries:\n  # One block per observation. id = <PREFIX>-<3+ digits>. Any uppercase prefix is valid;\n  # DL/MW/GFT/INS/COORD/SUGG/CONF are the recommended per-kind defaults, and run-scoped\n  # prefixes (e.g. VF- for a flow worker's own numbering) are equally fine.\n  # kind in difficulty | magic-wand | gift | insight | coordination | improvement-suggestion | confusion\n  - id: DL-001\n    kind: difficulty\n    description: \"<>=10 chars - the friction, concretely>\"\n    target: tooling                         # project | tooling | plan | skill | doc | infra | minih | ...\n    severity: degrading                     # blocking | degrading | annoying  (for kind: difficulty)\n    workaround: \"<what you did to get past it>\"\n    suggested_encoding: \"<e.g. justfile recipe wrapping ripgrep>\"\n    system:\n      compound:                             # CONVENTION (open 'system' object), not a schema field\n        status: open                        # open | suggested | encoded | wontfix | stale | dismissed\n        source: agent-self                  # user | agent-self\n        first_seen_at: \"<ISO8601Z>\"\n---\n\n# Retro \u2014 <plan or session label>\n\n<!-- Optional human narrative. The structured `entries` above are the durable signal. -->\n";
+/** The core `retro` record type (always present, even under \`--no-extensions\`). */
+export declare const retroRecordType: HarnessRecordType;

package/harness/cli/dist/services/record/core-types/retro.js

@@ -0,0 +1,55 @@
+/**
+ * The core-bundled `retro` record type. Inline TS constant (plan Q-A "lean"):
+ * ships cleanly via `npx` with no `package.json#files`/packaging change, mirroring
+ * `services/scaffold/templates.ts`.
+ *
+ * `RETRO_TEMPLATE` is a **deployment echo** of the frozen
+ * `skills/eng-harness-loop/eng-harness-4-retro/references/retro.schema.json`: its
+ * frontmatter covers the schema's REQUIRED fields (`schema_version`, `retro_id`,
+ * `agent`, `started_at`) and uses only the schema's open `system` object. The
+ * schema stays the canonical contract; a future `schema?` field can attach it for
+ * opt-in validation without changing this type's shape. A unit test
+ * (`retro-template.test.ts`) pins the superset so the two can't drift.
+ *
+ * NOTE: `system.compound.*` below is a documented **convention** inside the
+ * schema's open `system` object — NOT a schema-defined field.
+ */
+export const RETRO_TEMPLATE = `---
+schema_version: "1.0"
+retro_id: "<ISO8601Z>-<agent>-<hash>"     # e.g. 2026-06-09T09:55:00Z-github-copilot-a8f3
+agent: "<your-agent-slug>"                 # lowercase kebab, e.g. github-copilot
+plan_id: "<NNN-slug or null>"
+started_at: "<ISO8601Z>"
+ended_at: "<ISO8601Z>"
+summary: "<one paragraph: what happened this session>"
+entries:
+  # One block per observation. id = <PREFIX>-<3+ digits>. Any uppercase prefix is valid;
+  # DL/MW/GFT/INS/COORD/SUGG/CONF are the recommended per-kind defaults, and run-scoped
+  # prefixes (e.g. VF- for a flow worker's own numbering) are equally fine.
+  # kind in difficulty | magic-wand | gift | insight | coordination | improvement-suggestion | confusion
+  - id: DL-001
+    kind: difficulty
+    description: "<>=10 chars - the friction, concretely>"
+    target: tooling                         # project | tooling | plan | skill | doc | infra | minih | ...
+    severity: degrading                     # blocking | degrading | annoying  (for kind: difficulty)
+    workaround: "<what you did to get past it>"
+    suggested_encoding: "<e.g. justfile recipe wrapping ripgrep>"
+    system:
+      compound:                             # CONVENTION (open 'system' object), not a schema field
+        status: open                        # open | suggested | encoded | wontfix | stale | dismissed
+        source: agent-self                  # user | agent-self
+        first_seen_at: "<ISO8601Z>"
+---
+
+# Retro — <plan or session label>
+
+<!-- Optional human narrative. The structured \`entries\` above are the durable signal. -->
+`;
+/** The core `retro` record type (always present, even under \`--no-extensions\`). */
+export const retroRecordType = {
+    kind: 'record',
+    type: 'retro',
+    description: 'Harness loop retrospective — session friction, gifts, magic-wand wishes.',
+    template: RETRO_TEMPLATE,
+};
+//# sourceMappingURL=retro.js.map

package/harness/cli/dist/services/record/core-types/retro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retro.js","sourceRoot":"","sources":["../../../../src/services/record/core-types/retro.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8B7B,CAAC;AAEF,qFAAqF;AACrF,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,0EAA0E;IACvF,QAAQ,EAAE,cAAc;CACzB,CAAC"}

package/harness/cli/dist/services/record/record-service.d.ts

@@ -0,0 +1,38 @@
+import type { Clock } from '../../adapters/clock/clock-port.js';
+import type { FsPort } from '../../adapters/fs/fs-port.js';
+import type { ProcessPort } from '../../adapters/process/process-port.js';
+import { ensureTemp } from '../shared/temp.js';
+import type { RecordRegistry } from './registry.js';
+export { ensureTemp };
+export interface RecordDeps {
+    fs: FsPort;
+    clock: Clock;
+    proc: ProcessPort;
+}
+export interface RecordCreateOptions {
+    /** The record type (the `<type>` arg). */
+    type?: string;
+    /** Optional slug for the filename; slugified to `[a-z0-9-]`. Absent → ordinal-only name (`<NNN>.md`). */
+    slug?: string;
+}
+export type RecordOutcome = {
+    ok: true;
+    type: string;
+    path: string;
+    source: 'core' | 'extension';
+} | {
+    ok: false;
+    status: 'error' | 'unconfigured';
+    code?: string;
+    message: string;
+    next_action: string;
+};
+/** Lowercase + strip to `[a-z0-9-]`, collapsing/​trimming separators. */
+export declare function slugify(raw: string): string;
+/**
+ * Scaffold a record file for `harness record <type>`. Resolves the type in the
+ * merged registry, computes a never-clobbering path, ensures the scratch buffer,
+ * and writes the type's template. Returns a typed outcome the act maps onto the
+ * Envelope + exit code (ok → 0, unconfigured → 2, error → 1).
+ */
+export declare function createRecord(opts: RecordCreateOptions, registry: RecordRegistry, deps: RecordDeps): RecordOutcome;

package/harness/cli/dist/services/record/record-service.js

@@ -0,0 +1,144 @@
+import { ErrorCodes } from '../../output/error-codes.js';
+import { posixJoin, toPosix } from '../shared/posix-path.js';
+import { ensureTemp, HARNESS_DIR } from '../shared/temp.js';
+// Relocated to services/shared/temp.ts (plan 015 D1); re-exported so existing
+// consumers (and tests) keep their import path.
+export { ensureTemp };
+/**
+ * Pure record-scaffolding logic behind injected ports (`fs`/`clock`/`proc`). Like
+ * `services/scaffold`, it never imports `node:fs` or `process.cwd()` (Constitution
+ * P2), so it is unit-testable with fakes. The CLI owns placement uniformly:
+ * `.harness/records/<type>/<YYYY-MM-DD>/<NNN>-<slug>.md` — the UTC date (via the
+ * Clock) is a directory and `<NNN>` is a per-day, per-type ordinal (001, 002, …),
+ * so records sort chronologically within the day and never clobber an existing file.
+ */
+const RECORDS_DIR = 'records';
+const TYPE_PATTERN = /^[a-z][a-z0-9-]*$/;
+/** Max per-day ordinal (keeps `<NNN>` 3 digits); refuse beyond rather than clobber. */
+const MAX_ORDINAL = 999;
+/** Lowercase + strip to `[a-z0-9-]`, collapsing/​trimming separators. */
+export function slugify(raw) {
+    return raw
+        .trim()
+        .toLowerCase()
+        .replace(/\s+/g, '-')
+        .replace(/[^a-z0-9-]+/g, '')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+/** `YYYY-MM-DD` from the injected Clock's UTC ISO instant (deterministic in tests). */
+function dateStamp(clock) {
+    return clock.nowIso().slice(0, 10);
+}
+/**
+ * Next 1-based ordinal for a date dir: 1 + the highest `NNN` prefix already
+ * present (files are named `<NNN>[-slug].md`). Missing/empty dir → 1.
+ */
+function nextOrdinal(fs, dateDir) {
+    let max = 0;
+    for (const name of fs.readdir(dateDir)) {
+        const m = /^(\d+)(?:-|\.)/.exec(name);
+        if (m) {
+            const n = Number.parseInt(m[1], 10);
+            if (n > max)
+                max = n;
+        }
+    }
+    return max + 1;
+}
+/**
+ * Scaffold a record file for `harness record <type>`. Resolves the type in the
+ * merged registry, computes a never-clobbering path, ensures the scratch buffer,
+ * and writes the type's template. Returns a typed outcome the act maps onto the
+ * Envelope + exit code (ok → 0, unconfigured → 2, error → 1).
+ */
+export function createRecord(opts, registry, deps) {
+    const { fs, clock, proc } = deps;
+    // Logical paths are POSIX on every OS (plan 017) — convert once at the boundary.
+    const cwd = toPosix(proc.cwd());
+    const harnessDir = posixJoin(cwd, HARNESS_DIR);
+    // 1. Honest `unconfigured` when there's no harness to record into.
+    if (!fs.exists(harnessDir)) {
+        return {
+            ok: false,
+            status: 'unconfigured',
+            message: `No ${HARNESS_DIR}/ directory found in ${cwd}.`,
+            next_action: `No \`${HARNESS_DIR}/\` here — set up the harness first (create \`${HARNESS_DIR}/\`), then re-run.`,
+        };
+    }
+    // 2. Resolve the type in the merged registry (core ∪ extension).
+    const type = opts.type ?? '';
+    const known = registry.types.map((t) => t.type);
+    const entry = registry.types.find((t) => t.type === type);
+    if (!TYPE_PATTERN.test(type) || entry === undefined) {
+        return {
+            ok: false,
+            status: 'error',
+            code: ErrorCodes.RECORD_TYPE_UNKNOWN,
+            message: `Unknown record type: ${JSON.stringify(type)}.`,
+            next_action: `Unknown record type \`${type}\`. Known: ${known.join(', ') || '(none)'} (run \`harness record --list\`).`,
+        };
+    }
+    // 3. Optional slug → slugified; an explicit slug that empties out is an error.
+    let slug;
+    if (opts.slug !== undefined) {
+        const cleaned = slugify(opts.slug);
+        if (cleaned.length === 0) {
+            return {
+                ok: false,
+                status: 'error',
+                code: ErrorCodes.INVALID_ARGS,
+                message: `Invalid --slug ${JSON.stringify(opts.slug)} (nothing left after slugify).`,
+                next_action: 'Pass a slug of [a-z0-9-], e.g. `--slug my-note`.',
+            };
+        }
+        slug = cleaned;
+    }
+    // 4. Resolve a never-clobbering path: <date>/<NNN>[-<slug>].md — the date is a
+    //    directory and <NNN> is a per-day, per-type ordinal = 1 + the highest already
+    //    present, so a fresh higher ordinal can't collide with an existing record.
+    const date = dateStamp(clock);
+    const dir = posixJoin(harnessDir, RECORDS_DIR, type, date);
+    const fileFor = (ord) => {
+        const nnn = String(ord).padStart(3, '0');
+        return slug ? `${nnn}-${slug}.md` : `${nnn}.md`;
+    };
+    let ordinal = nextOrdinal(fs, dir);
+    let fileName = fileFor(ordinal);
+    // Defensive: if readdir lagged and the computed name somehow exists, bump on.
+    while (fs.exists(posixJoin(dir, fileName)) && ordinal < MAX_ORDINAL) {
+        ordinal += 1;
+        fileName = fileFor(ordinal);
+    }
+    const fileAbs = posixJoin(dir, fileName);
+    const relPath = posixJoin(HARNESS_DIR, RECORDS_DIR, type, date, fileName);
+    // 5. Exhaustion guard: refuse rather than clobber (or overflow to 4 digits) at the
+    //    practically-unreachable limit of MAX_ORDINAL same-day records of this type.
+    if (ordinal > MAX_ORDINAL || fs.exists(fileAbs)) {
+        return {
+            ok: false,
+            status: 'error',
+            code: ErrorCodes.RECORD_WRITE_FAILED,
+            message: `Ordinal space exhausted for ${posixJoin(HARNESS_DIR, RECORDS_DIR, type, date)} (${MAX_ORDINAL}+ same-day ${type} records).`,
+            next_action: `Too many \`${type}\` records on ${date} — start a new day or prune the folder.`,
+        };
+    }
+    // 6. Ensure the scratch buffer (AC-17) + write the template — both under ONE guard so
+    //    a permissions failure on `.harness/` surfaces as E181 (not a generic E100).
+    try {
+        ensureTemp(deps);
+        fs.mkdirp(dir);
+        fs.writeText(fileAbs, entry.template);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            status: 'error',
+            code: ErrorCodes.RECORD_WRITE_FAILED,
+            message: `Could not write ${relPath}: ${err instanceof Error ? err.message : String(err)}`,
+            next_action: `Could not write \`${relPath}\` (permissions?). Check \`${HARNESS_DIR}/\` is writable.`,
+        };
+    }
+    return { ok: true, type, path: relPath, source: entry.source };
+}
+//# sourceMappingURL=record-service.js.map

package/harness/cli/dist/services/record/record-service.js.map

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

package/harness/cli/dist/services/record/registry.d.ts

@@ -0,0 +1,46 @@
+import type { HarnessRecordType } from './contract.js';
+/** A resolved record type in the merged registry, with its provenance. */
+export interface RecordTypeEntry {
+    type: string;
+    description: string;
+    template: string;
+    source: 'core' | 'extension';
+    /** Present for `source: 'extension'` — the discovered file the type came from. */
+    entryPath?: string;
+}
+/** An extension-provided record type, paired with the file it was discovered in. */
+export interface ExtensionRecordType {
+    recordType: HarnessRecordType;
+    entryPath: string;
+}
+/** An extension record type dropped because its `type` was already claimed. */
+export interface RecordTypeConflict {
+    type: string;
+    entryPath: string;
+    /** What it collided with: an existing `core` type or an `extension` loaded earlier. */
+    shadows: 'core' | 'extension';
+}
+/** The merged record-type surface (core ∪ extension) + the conflicts `doctor` reports. */
+export interface RecordRegistry {
+    /** Accepted types, deterministic order: core first, then de-conflicted extensions. */
+    types: RecordTypeEntry[];
+    /** Extension types skipped because their `type` was already claimed (never fatal). */
+    conflicts: RecordTypeConflict[];
+}
+/** The core-bundled record types — always present, even under `--no-extensions`. */
+export declare const coreRecordTypes: HarnessRecordType[];
+/**
+ * Field-level issues for a record-type export (empty array = well-formed). Mirrors
+ * `verbShapeIssues`: a malformed `kind:'record'` export becomes a clean `E140`
+ * (recorded by `doctor`, non-fatal) instead of crashing `harness record`.
+ */
+export declare function recordTypeShapeIssues(value: unknown): string[];
+/**
+ * Merge core ∪ extension record types into one registry. Core types are
+ * **reserved** — an extension declaring an existing core `type` is recorded as a
+ * conflict and the core definition wins; two extensions with the same `type` →
+ * first-loaded wins, the other is a conflict. The merge is deterministic and
+ * defensive: even if a caller passes un-deconflicted extension types, duplicates
+ * are dropped here (the loader normally de-conflicts first). Never throws.
+ */
+export declare function buildRecordRegistry(core?: readonly HarnessRecordType[], extension?: readonly ExtensionRecordType[]): RecordRegistry;

package/harness/cli/dist/services/record/registry.js

@@ -0,0 +1,71 @@
+import { retroRecordType } from './core-types/retro.js';
+/** Same name rule as verb names — the `<type>` arg + the records subdir name. */
+const TYPE_PATTERN = /^[a-z][a-z0-9-]*$/;
+/** The core-bundled record types — always present, even under `--no-extensions`. */
+export const coreRecordTypes = [retroRecordType];
+/**
+ * Field-level issues for a record-type export (empty array = well-formed). Mirrors
+ * `verbShapeIssues`: a malformed `kind:'record'` export becomes a clean `E140`
+ * (recorded by `doctor`, non-fatal) instead of crashing `harness record`.
+ */
+export function recordTypeShapeIssues(value) {
+    if (value === null || typeof value !== 'object') {
+        return ['not an object'];
+    }
+    const rt = value;
+    const issues = [];
+    if (rt.kind !== 'record') {
+        issues.push("missing kind:'record'");
+    }
+    if (typeof rt.type !== 'string' || !TYPE_PATTERN.test(rt.type)) {
+        issues.push('missing or invalid type (must match ^[a-z][a-z0-9-]*$)');
+    }
+    if (typeof rt.description !== 'string' || rt.description.length === 0) {
+        issues.push('missing or empty description');
+    }
+    if (typeof rt.template !== 'string' || rt.template.length === 0) {
+        issues.push('missing or empty template');
+    }
+    return issues;
+}
+/**
+ * Merge core ∪ extension record types into one registry. Core types are
+ * **reserved** — an extension declaring an existing core `type` is recorded as a
+ * conflict and the core definition wins; two extensions with the same `type` →
+ * first-loaded wins, the other is a conflict. The merge is deterministic and
+ * defensive: even if a caller passes un-deconflicted extension types, duplicates
+ * are dropped here (the loader normally de-conflicts first). Never throws.
+ */
+export function buildRecordRegistry(core = coreRecordTypes, extension = []) {
+    const types = [];
+    const conflicts = [];
+    const claimed = new Set();
+    const coreNames = new Set(core.map((t) => t.type));
+    for (const t of core) {
+        if (claimed.has(t.type)) {
+            continue;
+        }
+        claimed.add(t.type);
+        types.push({ type: t.type, description: t.description, template: t.template, source: 'core' });
+    }
+    for (const { recordType: t, entryPath } of extension) {
+        if (claimed.has(t.type)) {
+            conflicts.push({
+                type: t.type,
+                entryPath,
+                shadows: coreNames.has(t.type) ? 'core' : 'extension',
+            });
+            continue;
+        }
+        claimed.add(t.type);
+        types.push({
+            type: t.type,
+            description: t.description,
+            template: t.template,
+            source: 'extension',
+            entryPath,
+        });
+    }
+    return { types, conflicts };
+}
+//# sourceMappingURL=registry.js.map

package/harness/cli/dist/services/record/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/services/record/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,iFAAiF;AACjF,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAkCzC,oFAAoF;AACpF,MAAM,CAAC,MAAM,eAAe,GAAwB,CAAC,eAAe,CAAC,CAAC;AAEtE;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,CAAC,eAAe,CAAC,CAAC;IAC3B,CAAC;IACD,MAAM,EAAE,GAAG,KAAmC,CAAC;IAC/C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,EAAE,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/D,MAAM,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,OAAO,EAAE,CAAC,WAAW,KAAK,QAAQ,IAAI,EAAE,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtE,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,OAAO,EAAE,CAAC,QAAQ,KAAK,QAAQ,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAqC,eAAe,EACpD,YAA4C,EAAE;IAE9C,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,MAAM,SAAS,GAAyB,EAAE,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEnD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACjG,CAAC;IAED,KAAK,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,SAAS,EAAE,CAAC;QACrD,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,SAAS;gBACT,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW;aACtD,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,MAAM,EAAE,WAAW;YACnB,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC9B,CAAC"}

package/harness/cli/dist/services/scaffold/scaffold-service.d.ts

@@ -0,0 +1,29 @@
+import type { FsPort } from '../../adapters/fs/fs-port.js';
+import type { ProcessPort } from '../../adapters/process/process-port.js';
+import { type ScaffoldVariant } from './templates.js';
+export interface ScaffoldOptions {
+    name: string;
+    wrap?: string;
+    js?: boolean;
+    force?: boolean;
+    /** Scaffold a record-type extension (`kind:'record'`) instead of a verb. */
+    record?: boolean;
+}
+export type ScaffoldOutcome = {
+    ok: true;
+    /** Relative path of the entry file (`.harness/extensions/<name>/extension.<ext>`). */
+    path: string;
+    /** Relative path of the starter briefing (`.harness/extensions/<name>/instructions.md`). */
+    instructionsPath: string;
+    verb: string;
+    variant: ScaffoldVariant;
+} | {
+    ok: false;
+    code: string;
+    message: string;
+    next_action: string;
+};
+export declare function scaffoldExtension(opts: ScaffoldOptions, deps: {
+    fs: FsPort;
+    proc: ProcessPort;
+}): ScaffoldOutcome;

package/harness/cli/dist/services/scaffold/scaffold-service.js

@@ -0,0 +1,88 @@
+import { ErrorCodes } from '../../output/error-codes.js';
+import { RESERVED_NAMES } from '../extensions/registry.js';
+import { posixJoin, toPosix } from '../shared/posix-path.js';
+import { renderStarter, starterInstructions } from './templates.js';
+/**
+ * Scaffold a new extension PACKAGE for `harness new` (plan 006; folder form
+ * since plan 014 AC-8): `<name>/extension.<ext>` + a starter `instructions.md`
+ * beside it. Pure harness logic behind injected ports: validates the verb name,
+ * roots the target the SAME way discovery does
+ * (`posixJoin(toPosix(proc.cwd()), '.harness', 'extensions', …)` — Finding 07;
+ * logical paths are POSIX on every OS, plan 017), picks a starter template, and
+ * writes via `FsPort`. Never imports `node:fs` or `process.cwd()` (Constitution
+ * P2), so it is unit-testable with fakes.
+ */
+const EXTENSIONS_DIR = ['.harness', 'extensions'];
+// Hyphen-separated alphanumeric segments — no trailing/doubled hyphens, since
+// the name is now also a directory name (companion F002).
+const NAME_PATTERN = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+// A --wrap value is embedded verbatim into the generated file. v1 supports a
+// simple `cmd arg arg` line only; reject anything that could break the emitted
+// JS (quotes, backticks, `$`, backslash, shell operators) rather than write
+// invalid code (F002). Quoting/operators are a documented v1 non-goal.
+const SAFE_WRAP_PATTERN = /^[\w\-./:= ]+$/;
+export function scaffoldExtension(opts, deps) {
+    const { name, wrap, js = false, force = false, record = false } = opts;
+    const { fs, proc } = deps;
+    if (!NAME_PATTERN.test(name)) {
+        return {
+            ok: false,
+            code: ErrorCodes.SCAFFOLD_INVALID_NAME,
+            message: `Invalid extension name: ${JSON.stringify(name)}`,
+            next_action: 'Use a lowercase, hyphenated name starting with a letter, e.g. `harness new my-verb`.',
+        };
+    }
+    if (RESERVED_NAMES.has(name)) {
+        return {
+            ok: false,
+            code: ErrorCodes.SCAFFOLD_NAME_RESERVED,
+            message: `'${name}' is a reserved core command and cannot be an extension verb.`,
+            next_action: `Choose a different verb name (reserved: ${[...RESERVED_NAMES].join(', ')}).`,
+        };
+    }
+    if (!record &&
+        wrap !== undefined &&
+        (wrap.trim().length === 0 || !SAFE_WRAP_PATTERN.test(wrap))) {
+        return {
+            ok: false,
+            code: ErrorCodes.INVALID_ARGS,
+            message: `Unsupported --wrap command: ${JSON.stringify(wrap)}`,
+            next_action: 'Use a simple "cmd arg arg" form (letters, digits, - _ . / : =). For quotes/operators, scaffold without --wrap and edit the generated run() by hand.',
+        };
+    }
+    const { contents, variant, ext } = renderStarter({ name, js, wrap, record });
+    // Folder form (plan 014 AC-8): every variant lands at <name>/extension.<ext>
+    // (the `.record.ts` filename convention is retired — routing is by `kind`).
+    const fileName = `extension.${ext}`;
+    const relPath = posixJoin(...EXTENSIONS_DIR, name, fileName);
+    const relInstructions = posixJoin(...EXTENSIONS_DIR, name, 'instructions.md');
+    const dirAbs = posixJoin(toPosix(proc.cwd()), ...EXTENSIONS_DIR, name);
+    const fileAbs = posixJoin(dirAbs, fileName);
+    const instructionsAbs = posixJoin(dirAbs, 'instructions.md');
+    if (!force && fs.exists(fileAbs)) {
+        return {
+            ok: false,
+            code: ErrorCodes.SCAFFOLD_FILE_EXISTS,
+            message: `An extension already exists at ${relPath}.`,
+            next_action: 'Pass --force to overwrite, or choose another name.',
+        };
+    }
+    try {
+        fs.mkdirp(dirAbs);
+        fs.writeText(fileAbs, contents);
+        // Never clobber an authored briefing — --force replaces code, not judgment.
+        if (!fs.exists(instructionsAbs)) {
+            fs.writeText(instructionsAbs, starterInstructions(name));
+        }
+    }
+    catch (err) {
+        return {
+            ok: false,
+            code: ErrorCodes.SCAFFOLD_WRITE_FAILED,
+            message: `Could not write ${relPath}: ${err instanceof Error ? err.message : String(err)}`,
+            next_action: 'Check directory permissions and retry.',
+        };
+    }
+    return { ok: true, path: relPath, instructionsPath: relInstructions, verb: name, variant };
+}
+//# sourceMappingURL=scaffold-service.js.map

package/harness/cli/dist/services/scaffold/scaffold-service.js.map

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

package/harness/cli/dist/services/scaffold/templates.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Pure string builders for the scaffolded extension starters (`harness new`,
+ * plan 006). Output is byte-exact to workshop 001 §4 so it can be asserted in
+ * tests and survives `npx`/bundling (no loose template files to resolve at
+ * runtime). Authors never see this module — only the file it writes.
+ */
+export type ScaffoldVariant = 'minimal-ts' | 'minimal-js' | 'wrap-ts' | 'wrap-js' | 'record-ts';
+/** kebab/lower verb name → a valid camelCase JS identifier for the local const. */
+export declare function toIdentifier(name: string): string;
+/** Minimal TypeScript starter — an honest `unconfigured` stub (workshop §4a). */
+export declare function minimalTs(name: string): string;
+/** Wrap-a-real-command TypeScript starter (workshop §4b). */
+export declare function wrapTs(name: string, command: string): string;
+/** Minimal plain-JS starter — JSDoc contract reference, no runtime import (workshop §4c). */
+export declare function minimalJs(name: string): string;
+/** Wrap-a-real-command plain-JS starter (workshop §4d). */
+export declare function wrapJs(name: string, command: string): string;
+/**
+ * Record-type extension starter (`harness new <name> --record`). Exports a
+ * {@link HarnessRecordType} the loader discovers by its `kind:'record'`. The
+ * record's "schema" lives in the `template` body (frontmatter + comments); the
+ * CLI is schema-agnostic, so editing the template is all it takes to design a type.
+ */
+export declare function recordTs(name: string): string;
+/**
+ * Starter `instructions.md` for a scaffolded extension package (plan 014 AC-8).
+ * A guided TODO addressed to the CALLING agent: what the verb computes
+ * deterministically, and what judgment it expects back. Served verbatim by
+ * `harness instructions <name>` once authored.
+ */
+export declare function starterInstructions(name: string): string;
+/** Pick the starter + extension from the `harness new` flags. */
+export declare function renderStarter(opts: {
+    name: string;
+    js: boolean;
+    wrap?: string;
+    record?: boolean;
+}): {
+    contents: string;
+    variant: ScaffoldVariant;
+    ext: 'ts' | 'js';
+};