@aperant/framework 0.6.3 → 0.6.5

package/dist/cli/commands/context.mjs

@@ -0,0 +1,224 @@
+/**
+ * commands/context.mjs — `apt-tools context write` (Pocock adoption ST-5, AC4).
+ *
+ * Upserts a term-block into the project's CONTEXT.md (the persistent
+ * project glossary). Format ported from Pocock's CONTEXT-FORMAT.md
+ * (see packages/framework/templates/context-format.md for the MIT
+ * attribution + field semantics).
+ *
+ * Idempotent: re-running with the same `--term` updates the existing
+ * block in place. Fields not explicitly overridden via flags are
+ * preserved from the prior block.
+ *
+ * CLI:
+ *   apt-tools context write <project-dir>
+ *     --term <bold-term>
+ *     --definition <one-line>
+ *     [--aliases-to-avoid alias1,alias2]
+ *     [--cardinality 'one-to-many' | 'one-to-one' | 'many-to-many']
+ *     [--flagged-ambiguity 'note']
+ *     [--example-dialogue 'example']
+ *
+ * Output: JSON envelope { status: 'ok' | 'error',
+ *                         command: 'context-write',
+ *                         file: <absolute path>,
+ *                         term: <term>,
+ *                         operation: 'created' | 'updated' }.
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { parseFlags } from '../util/args.mjs';
+import { err, ok } from '../util/result.mjs';
+const HEADER = '# Project glossary (CONTEXT.md)';
+const HEADER_NOTE = '<!-- Managed by `apt-tools context write`. Hand-edits are preserved across upserts. -->';
+/**
+ * Parse a single term-block out of CONTEXT.md.
+ *
+ * A block looks like:
+ *   ## {Term}
+ *
+ *   {Definition line}
+ *
+ *   - **Aliases to avoid:** ...
+ *   - **Cardinality:** ...
+ *   - **Flagged ambiguities:** ...
+ *   - **Example dialogue:** ...
+ *
+ * Returns `{ definition, aliasesToAvoid, cardinality, flaggedAmbiguity, exampleDialogue }`
+ * with each field as a string or null.
+ *
+ * @param {string} blockText
+ */
+function parseBlock(blockText) {
+    const lines = blockText.split('\n');
+    // First non-empty line after the ## header is the definition.
+    let definition = '';
+    let i = 0;
+    while (i < lines.length && lines[i].trim() === '')
+        i++;
+    if (i < lines.length && !lines[i].startsWith('- ')) {
+        definition = lines[i].trim();
+        i++;
+    }
+    const fields = {
+        aliasesToAvoid: null,
+        cardinality: null,
+        flaggedAmbiguity: null,
+        exampleDialogue: null,
+    };
+    for (; i < lines.length; i++) {
+        const line = lines[i];
+        const m = line.match(/^- \*\*([^*]+):\*\*\s*(.*)$/);
+        if (!m)
+            continue;
+        const key = m[1].trim();
+        const value = m[2].trim();
+        switch (key) {
+            case 'Aliases to avoid':
+                fields.aliasesToAvoid = value;
+                break;
+            case 'Cardinality':
+                fields.cardinality = value;
+                break;
+            case 'Flagged ambiguities':
+                fields.flaggedAmbiguity = value;
+                break;
+            case 'Example dialogue':
+                fields.exampleDialogue = value;
+                break;
+        }
+    }
+    return { definition, ...fields };
+}
+/**
+ * Render a term-block to markdown.
+ *
+ * @param {string} term
+ * @param {{
+ *   definition: string,
+ *   aliasesToAvoid: string|null,
+ *   cardinality: string|null,
+ *   flaggedAmbiguity: string|null,
+ *   exampleDialogue: string|null,
+ * }} block
+ */
+function renderBlock(term, block) {
+    const lines = [`## ${term}`, '', block.definition, ''];
+    const fields = [
+        ['Aliases to avoid', block.aliasesToAvoid],
+        ['Cardinality', block.cardinality],
+        ['Flagged ambiguities', block.flaggedAmbiguity],
+        ['Example dialogue', block.exampleDialogue],
+    ];
+    for (const [key, value] of fields) {
+        if (value !== null && value !== undefined && value !== '') {
+            lines.push(`- **${key}:** ${value}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Find an existing block by term in the source markdown.
+ * Returns `{ start, end, prior }` or `null` if no such block exists.
+ * `start` and `end` are inclusive/exclusive offsets into `source`.
+ *
+ * @param {string} source
+ * @param {string} term
+ */
+function findBlock(source, term) {
+    const escaped = term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const headerRe = new RegExp(`^##\\s+${escaped}\\s*$`, 'm');
+    const m = headerRe.exec(source);
+    if (!m)
+        return null;
+    const start = m.index;
+    // Find the next ## or # header or EOF. LOG-004: including H1 prevents a
+    // manually-inserted `# Heading` from being absorbed into the block's content.
+    const tail = source.slice(m.index + m[0].length);
+    const nextRe = /^#{1,2}\s+/m;
+    const nextMatch = nextRe.exec(tail);
+    const end = nextMatch ? m.index + m[0].length + nextMatch.index : source.length;
+    const blockText = source.slice(m.index + m[0].length, end);
+    return { start, end, prior: parseBlock(blockText) };
+}
+/**
+ * CLI entry: `apt-tools context <subcommand> <project-dir> [flags]`.
+ *
+ * Only `write` is supported in v1; other subcommands return a usage error.
+ */
+export function cmdContext(subcommand, projectDir, extraArgs) {
+    if (subcommand !== 'write') {
+        return err('Usage: apt-tools context write <project-dir> --term <term> --definition <line> [--aliases-to-avoid ...] [--cardinality ...] [--flagged-ambiguity ...] [--example-dialogue ...]', 1, { command: 'context' });
+    }
+    if (!projectDir) {
+        return err('Usage: apt-tools context write <project-dir> --term <term> --definition <line>', 1, {
+            command: 'context-write',
+        });
+    }
+    const flags = parseFlags(extraArgs ?? []);
+    const term = flags.get('term');
+    const definition = flags.get('definition');
+    if (typeof term !== 'string' || term.trim() === '') {
+        return err('--term <bold-term> is required', 1, { command: 'context-write' });
+    }
+    if (typeof definition !== 'string' || definition.trim() === '') {
+        return err('--definition <one-line> is required', 1, { command: 'context-write' });
+    }
+    const absProjectDir = resolve(projectDir);
+    if (!existsSync(absProjectDir)) {
+        return err(`project directory not found: ${absProjectDir}`, 1, {
+            command: 'context-write',
+        });
+    }
+    const contextPath = resolve(absProjectDir, 'CONTEXT.md');
+    let source = '';
+    if (existsSync(contextPath)) {
+        source = readFileSync(contextPath, 'utf-8');
+    }
+    else {
+        source = `${HEADER}\n\n${HEADER_NOTE}\n\n`;
+    }
+    // Ensure the file starts with the header even if it existed pre-Pocock.
+    if (!source.startsWith(HEADER)) {
+        source = `${HEADER}\n\n${HEADER_NOTE}\n\n${source}`;
+    }
+    const existing = findBlock(source, term);
+    const incoming = {
+        definition,
+        aliasesToAvoid: typeof flags.get('aliases-to-avoid') === 'string' ? flags.get('aliases-to-avoid') : null,
+        cardinality: typeof flags.get('cardinality') === 'string' ? flags.get('cardinality') : null,
+        flaggedAmbiguity: typeof flags.get('flagged-ambiguity') === 'string' ? flags.get('flagged-ambiguity') : null,
+        exampleDialogue: typeof flags.get('example-dialogue') === 'string' ? flags.get('example-dialogue') : null,
+    };
+    // Merge: prior block fields are preserved unless explicitly overridden.
+    const merged = existing
+        ? {
+            definition: incoming.definition, // definition always overrides
+            aliasesToAvoid: incoming.aliasesToAvoid ?? existing.prior.aliasesToAvoid,
+            cardinality: incoming.cardinality ?? existing.prior.cardinality,
+            flaggedAmbiguity: incoming.flaggedAmbiguity ?? existing.prior.flaggedAmbiguity,
+            exampleDialogue: incoming.exampleDialogue ?? existing.prior.exampleDialogue,
+        }
+        : incoming;
+    const rendered = renderBlock(term, merged);
+    let updated;
+    if (existing) {
+        // Replace the existing block (header + body) with the rendered one.
+        const before = source.slice(0, existing.start).replace(/\n+$/, '');
+        const after = source.slice(existing.end).replace(/^\n+/, '');
+        updated = `${before}\n\n${rendered}\n${after.length > 0 ? `\n${after}` : ''}`;
+    }
+    else {
+        // Append a new block at the end.
+        updated = `${source.replace(/\n+$/, '')}\n\n${rendered}\n`;
+    }
+    writeFileSync(contextPath, updated);
+    return ok({
+        status: 'ok',
+        command: 'context-write',
+        file: contextPath,
+        term,
+        operation: existing ? 'updated' : 'created',
+    });
+}
+//# sourceMappingURL=context.mjs.map

package/dist/cli/commands/context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.mjs","sourceRoot":"","sources":["../../../src/cli/commands/context.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAA;AAE5C,MAAM,MAAM,GAAG,iCAAiC,CAAA;AAChD,MAAM,WAAW,GAChB,yFAAyF,CAAA;AAE1F;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAS,UAAU,CAAC,SAAS;IAC5B,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACnC,8DAA8D;IAC9D,IAAI,UAAU,GAAG,EAAE,CAAA;IACnB,IAAI,CAAC,GAAG,CAAC,CAAA;IACT,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,CAAC,EAAE,CAAA;IACtD,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACpD,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QAC5B,CAAC,EAAE,CAAA;IACJ,CAAC;IACD,MAAM,MAAM,GAAG;QACd,cAAc,EAAE,IAAI;QACpB,WAAW,EAAE,IAAI;QACjB,gBAAgB,EAAE,IAAI;QACtB,eAAe,EAAE,IAAI;KACrB,CAAA;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QACrB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAA;QACnD,IAAI,CAAC,CAAC;YAAE,SAAQ;QAChB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QACvB,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QACzB,QAAQ,GAAG,EAAE,CAAC;YACb,KAAK,kBAAkB;gBACtB,MAAM,CAAC,cAAc,GAAG,KAAK,CAAA;gBAC7B,MAAK;YACN,KAAK,aAAa;gBACjB,MAAM,CAAC,WAAW,GAAG,KAAK,CAAA;gBAC1B,MAAK;YACN,KAAK,qBAAqB;gBACzB,MAAM,CAAC,gBAAgB,GAAG,KAAK,CAAA;gBAC/B,MAAK;YACN,KAAK,kBAAkB;gBACtB,MAAM,CAAC,eAAe,GAAG,KAAK,CAAA;gBAC9B,MAAK;QACP,CAAC;IACF,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,CAAA;AACjC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,WAAW,CAAC,IAAI,EAAE,KAAK;IAC/B,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;IACtD,MAAM,MAAM,GAAG;QACd,CAAC,kBAAkB,EAAE,KAAK,CAAC,cAAc,CAAC;QAC1C,CAAC,aAAa,EAAE,KAAK,CAAC,WAAW,CAAC;QAClC,CAAC,qBAAqB,EAAE,KAAK,CAAC,gBAAgB,CAAC;QAC/C,CAAC,kBAAkB,EAAE,KAAK,CAAC,eAAe,CAAC;KAC3C,CAAA;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACnC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YAC3D,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,OAAO,KAAK,EAAE,CAAC,CAAA;QACrC,CAAC;IACF,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,SAAS,CAAC,MAAM,EAAE,IAAI;IAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;IAC3D,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,UAAU,OAAO,OAAO,EAAE,GAAG,CAAC,CAAA;IAC1D,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC/B,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IACnB,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAA;IACrB,wEAAwE;IACxE,8EAA8E;IAC9E,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;IAChD,MAAM,MAAM,GAAG,aAAa,CAAA;IAC5B,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACnC,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAA;IAC/E,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC1D,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,CAAA;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS;IAC3D,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC5B,OAAO,GAAG,CACT,gLAAgL,EAChL,CAAC,EACD,EAAE,OAAO,EAAE,SAAS,EAAE,CACtB,CAAA;IACF,CAAC;IACD,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,OAAO,GAAG,CACT,gFAAgF,EAChF,CAAC,EACD;YACC,OAAO,EAAE,eAAe;SACxB,CACD,CAAA;IACF,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,IAAI,EAAE,CAAC,CAAA;IACzC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAC9B,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;IAC1C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACpD,OAAO,GAAG,CAAC,gCAAgC,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAA;IAC9E,CAAC;IACD,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAChE,OAAO,GAAG,CAAC,qCAAqC,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAA;IACnF,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACzC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAChC,OAAO,GAAG,CAAC,gCAAgC,aAAa,EAAE,EAAE,CAAC,EAAE;YAC9D,OAAO,EAAE,eAAe;SACxB,CAAC,CAAA;IACH,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,EAAE,YAAY,CAAC,CAAA;IACxD,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,MAAM,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;IAC5C,CAAC;SAAM,CAAC;QACP,MAAM,GAAG,GAAG,MAAM,OAAO,WAAW,MAAM,CAAA;IAC3C,CAAC;IACD,wEAAwE;IACxE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,MAAM,OAAO,WAAW,OAAO,MAAM,EAAE,CAAA;IACpD,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACxC,MAAM,QAAQ,GAAG;QAChB,UAAU;QACV,cAAc,EACb,OAAO,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,IAAI;QACzF,WAAW,EAAE,OAAO,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI;QAC3F,gBAAgB,EACf,OAAO,KAAK,CAAC,GAAG,CAAC,mBAAmB,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,IAAI;QAC3F,eAAe,EACd,OAAO,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,IAAI;KACzF,CAAA;IAED,wEAAwE;IACxE,MAAM,MAAM,GAAG,QAAQ;QACtB,CAAC,CAAC;YACA,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,8BAA8B;YAC/D,cAAc,EAAE,QAAQ,CAAC,cAAc,IAAI,QAAQ,CAAC,KAAK,CAAC,cAAc;YACxE,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,QAAQ,CAAC,KAAK,CAAC,WAAW;YAC/D,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB,IAAI,QAAQ,CAAC,KAAK,CAAC,gBAAgB;YAC9E,eAAe,EAAE,QAAQ,CAAC,eAAe,IAAI,QAAQ,CAAC,KAAK,CAAC,eAAe;SAC3E;QACF,CAAC,CAAC,QAAQ,CAAA;IAEX,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC1C,IAAI,OAAO,CAAA;IACX,IAAI,QAAQ,EAAE,CAAC;QACd,oEAAoE;QACpE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QAClE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QAC5D,OAAO,GAAG,GAAG,MAAM,OAAO,QAAQ,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;IAC9E,CAAC;SAAM,CAAC;QACP,iCAAiC;QACjC,OAAO,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,QAAQ,IAAI,CAAA;IAC3D,CAAC;IAED,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;IAEnC,OAAO,EAAE,CAAC;QACT,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,eAAe;QACxB,IAAI,EAAE,WAAW;QACjB,IAAI;QACJ,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;KAC3C,CAAC,CAAA;AACH,CAAC"}

package/dist/cli/commands/event.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"event.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/event.mjs"],"names":[],"mappings":"AAaA,uHA4OC"}
+{"version":3,"file":"event.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/event.mjs"],"names":[],"mappings":"AAsDA,uHA0OC"}

package/dist/cli/commands/event.mjs

@@ -1,7 +1,7 @@
 /**
  * commands/event.mjs — append-only event log for coordination history (C29).
  */
-import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { appendFileSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { hostname } from 'node:os';
 import { join, resolve } from 'node:path';
 import { readLifecycleEventsForDay } from '../coordination/event-log.mjs';
@@ -9,6 +9,44 @@ import { createCoordinationStore } from '../coordination/store.mjs';
 import { detectWorktree } from '../git/worktree-detect.mjs';
 import { parseFlags } from '../util/args.mjs';
 import { err, ok } from '../util/result.mjs';
+// QUA-003 / PRF-002 — single source of truth for valid event types.
+// VALID_EVENT_TYPES is the authoritative list; CI_WATCH_EVENT_TYPES is the O(1)
+// membership Set used to short-circuit ci-watch.* events to the JSONL path (D-04).
+const VALID_EVENT_TYPES = [
+    'task-claimed',
+    'task-completed',
+    'task-failed',
+    'wave-started',
+    'wave-completed',
+    'install.started',
+    'install.ok',
+    'install.failed',
+    'ci-watch.armed',
+    'ci-watch.tick',
+    'ci-watch.fix-pushed',
+    'ci-watch.stopped',
+];
+const CI_WATCH_EVENT_TYPES = new Set([
+    'ci-watch.armed',
+    'ci-watch.tick',
+    'ci-watch.fix-pushed',
+    'ci-watch.stopped',
+]);
+/**
+ * Append a ci-watch event to the per-day JSONL file (D-04).
+ * O(1) — no directory scan. Creates the events dir if missing.
+ * @param {string} eventsDir
+ * @param {object} payload
+ * @returns {{ jsonlFile: string, jsonlPath: string }}
+ */
+function appendToJsonl(eventsDir, payload) {
+    mkdirSync(eventsDir, { recursive: true });
+    const today = new Date().toISOString().slice(0, 10);
+    const jsonlFile = `${today}.jsonl`;
+    const jsonlPath = join(eventsDir, jsonlFile);
+    appendFileSync(jsonlPath, `${JSON.stringify(payload)}\n`, 'utf-8');
+    return { jsonlFile, jsonlPath };
+}
 export function cmdEvent(subcommand, projectDir, extraArgs) {
     if (!subcommand)
         return err('Usage: apt-tools event <append|list|rebuild-state> <project-dir> [flags]');
@@ -33,18 +71,12 @@ export function cmdEvent(subcommand, projectDir, extraArgs) {
             //   install.started — { task_id, ecosystem, pid, started_at, log_path }
             //   install.ok      — { task_id, ecosystem, duration_ms, log_path }
             //   install.failed  — { task_id, ecosystem, exit_code, duration_ms, reason, log_path }
-            const validTypes = [
-                'task-claimed',
-                'task-completed',
-                'task-failed',
-                'wave-started',
-                'wave-completed',
-                'install.started',
-                'install.ok',
-                'install.failed',
-            ];
-            if (!validTypes.includes(type)) {
-                return err(`Invalid event type: ${type}. Valid types: ${validTypes.join(', ')}`);
+            // C28 (post-ship CI watcher D-04) — added ci-watch.{armed,tick,fix-pushed,stopped}
+            // so /apt:watch-ci tick / start / stop can stream events into
+            // .aperant/events/{today}.jsonl. The rebuild-state switch below
+            // silently ignores them (they're informational, not task-lifecycle).
+            if (!VALID_EVENT_TYPES.includes(type)) {
+                return err(`Invalid event type: ${type}. Valid types: ${VALID_EVENT_TYPES.join(', ')}`);
             }
             let data = {};
             if (dataStr) {
@@ -55,6 +87,19 @@ export function cmdEvent(subcommand, projectDir, extraArgs) {
                     return err(`Invalid JSON for --data: ${e.message}`);
                 }
             }
+            // PRF-002 — ci-watch.* events go to the per-day JSONL path (D-04).
+            // O(1) append; no directory scan needed.
+            if (CI_WATCH_EVENT_TYPES.has(type)) {
+                const event = {
+                    type,
+                    subtask,
+                    worker: `${hostname()}-${process.pid}`,
+                    timestamp: new Date().toISOString(),
+                    data,
+                };
+                const { jsonlFile } = appendToJsonl(eventsDir, event);
+                return ok({ status: 'ok', command: 'event-append', event_file: jsonlFile, event });
+            }
             // Find next sequence number — scan existing files for highest number
             const existingFiles = readdirSync(eventsDir).filter((f) => f.endsWith('.json'));
             let maxId = 0;
@@ -159,17 +204,7 @@ export function cmdEvent(subcommand, projectDir, extraArgs) {
                 try {
                     const event = JSON.parse(readFileSync(join(eventsDir, f), 'utf-8'));
                     // Validate event type before processing (T-11-04 mitigation)
-                    const validTypes = [
-                        'task-claimed',
-                        'task-completed',
-                        'task-failed',
-                        'wave-started',
-                        'wave-completed',
-                        'install.started',
-                        'install.ok',
-                        'install.failed',
-                    ];
-                    if (!validTypes.includes(event.type))
+                    if (!VALID_EVENT_TYPES.includes(event.type))
                         continue;
                     eventsProcessed++;
                     switch (event.type) {

package/dist/cli/commands/event.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"event.mjs","sourceRoot":"","sources":["../../../src/cli/commands/event.mjs"],"names":[],"mappings":"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"}
+{"version":3,"file":"event.mjs","sourceRoot":"","sources":["../../../src/cli/commands/event.mjs"],"names":[],"mappings":"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"}

package/dist/cli/commands/host-detect.d.mts

@@ -1,3 +1,3 @@
 export function cmdHostDetect(): import("../util/result.mjs").CommandResult;
-export function cmdReconcile(projectDir: any): import("../util/result.mjs").CommandResult;
+export function cmdReconcile(projectDir: any, extraArgs?: any[]): import("../util/result.mjs").CommandResult;
 //# sourceMappingURL=host-detect.d.mts.map

package/dist/cli/commands/host-detect.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"host-detect.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/host-detect.mjs"],"names":[],"mappings":"AAeA,4EAOC;AAED,0FA8DC"}
+{"version":3,"file":"host-detect.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/host-detect.mjs"],"names":[],"mappings":"AAeA,4EAOC;AAgBD,6GA0EC"}

package/dist/cli/commands/host-detect.mjs

@@ -19,20 +19,37 @@ export function cmdHostDetect() {
         host,
     });
 }
-export function cmdReconcile(projectDir) {
+/**
+ * Parse `--track <quick|standard|deep>` from positional args. Returns the
+ * lowercased track or null when the flag is absent. Unknown values are
+ * silently ignored to preserve backward-compat — the caller falls back to
+ * global phase_delegation in that case.
+ */
+function parseTrackFlag(args) {
+    if (!Array.isArray(args))
+        return null;
+    const idx = args.indexOf('--track');
+    if (idx === -1 || idx === args.length - 1)
+        return null;
+    const val = String(args[idx + 1]).toLowerCase();
+    return val === 'quick' || val === 'standard' || val === 'deep' ? val : null;
+}
+export function cmdReconcile(projectDir, extraArgs = []) {
     if (!projectDir)
-        return err('Usage: apt-tools reconcile <project-dir>');
+        return err('Usage: apt-tools reconcile <project-dir> [--track quick|standard|deep]');
     const targetDir = resolve(projectDir);
     if (!existsSync(targetDir))
         return err(`Directory does not exist: ${targetDir}`);
     const host = detectHost();
     const { capabilities } = host;
+    const track = parseTrackFlag(extraArgs);
     // Read orchestration config — default all fields to 'auto' if missing
     let orchestrationConfig = {
         phase_delegation: 'auto',
         review_mode: 'auto',
         debate_mode: 'auto',
     };
+    let perTrack = null;
     const configPath = join(targetDir, '.aperant', 'config.json');
     if (existsSync(configPath)) {
         try {
@@ -43,14 +60,20 @@ export function cmdReconcile(projectDir) {
                     review_mode: cfg.orchestration.review_mode ?? 'auto',
                     debate_mode: cfg.orchestration.debate_mode ?? 'auto',
                 };
+                perTrack = cfg.orchestration.per_track ?? null;
             }
         }
         catch {
             // Malformed config — use defaults
         }
     }
+    // Per-track phase_delegation override (roundtable 2026-05-14 R7):
+    // when --track is passed AND per_track[track] is set, use that as
+    // the requested mode for phase_delegation. Otherwise fall back to
+    // the global value. review_mode and debate_mode are not track-scoped.
+    const requestedPhaseDelegation = track && perTrack?.[track] ? perTrack[track] : orchestrationConfig.phase_delegation;
     // Resolve each dimension
-    const pdResult = resolveMode(orchestrationConfig.phase_delegation, capabilities, 'phase_delegation');
+    const pdResult = resolveMode(requestedPhaseDelegation, capabilities, 'phase_delegation');
     const rmResult = resolveMode(orchestrationConfig.review_mode, capabilities, 'review_mode');
     const dmResult = resolveMode(orchestrationConfig.debate_mode, capabilities, 'debate_mode');
     const resolved = {
@@ -66,6 +89,10 @@ export function cmdReconcile(projectDir) {
         config: orchestrationConfig,
         resolved,
     };
+    if (track) {
+        result.track = track;
+        result.track_source = perTrack && perTrack[track] ? 'per_track' : 'fallback';
+    }
     if (downgrades.length > 0) {
         result.downgrades = downgrades;
     }

package/dist/cli/commands/host-detect.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"host-detect.mjs","sourceRoot":"","sources":["../../../src/cli/commands/host-detect.mjs"],"names":[],"mappings":"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"}
+{"version":3,"file":"host-detect.mjs","sourceRoot":"","sources":["../../../src/cli/commands/host-detect.mjs"],"names":[],"mappings":"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"}

package/dist/cli/commands/init.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/init.mjs"],"names":[],"mappings":"AAkEA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wCAHW,MAAM,EAAE,GACN;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,iBAAiB,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,GAAC,IAAI,CAAC;IAAC,WAAW,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,GAAC,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,GAAC,CAAC,GAAC,CAAC,GAAC,CAAC,CAAC;IAAC,mBAAmB,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAgD7N;AA+vBD;;;;;;GAMG;AACH,oCAJW,MAAM,cACN,MAAM,EAAE,GACN,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAiI3D;;;;;cAj4Ba,MAAM,EAAE;;;;qBACR,CAAC,GAAC,CAAC,GAAC,CAAC,GAAC,CAAC;;;;gBACP,MAAM,GAAC,MAAM;;;;4BACb,MAAM,EAAE;;;;aACR,OAAO;;;;mBACP,OAAO;eACP,OAAO,0BAA0B,EAAE,eAAe;;;;;;;;;aAErC,MAAM;eAAS,OAAO;cAAQ,MAAM;iBAAW,MAAM;;;;;;aAErD,MAAM;eAAS,OAAO;gBAAU,MAAM;;;;;;kBAEvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;0BAAoB,OAAO,EAAE;2BAAqB,OAAO,EAAE;oBAAc,OAAO,EAAE"}
+{"version":3,"file":"init.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/init.mjs"],"names":[],"mappings":"AAmEA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wCAHW,MAAM,EAAE,GACN;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,iBAAiB,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,GAAC,IAAI,CAAC;IAAC,WAAW,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,GAAC,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,GAAC,CAAC,GAAC,CAAC,GAAC,CAAC,CAAC;IAAC,mBAAmB,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAgD7N;AA40BD;;;;;;GAMG;AACH,oCAJW,MAAM,cACN,MAAM,EAAE,GACN,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAiI3D;;;;;cA98Ba,MAAM,EAAE;;;;qBACR,CAAC,GAAC,CAAC,GAAC,CAAC,GAAC,CAAC;;;;gBACP,MAAM,GAAC,MAAM;;;;4BACb,MAAM,EAAE;;;;aACR,OAAO;;;;mBACP,OAAO;eACP,OAAO,0BAA0B,EAAE,eAAe;;;;;;;;;aAErC,MAAM;eAAS,OAAO;cAAQ,MAAM;iBAAW,MAAM;;;;;;aAErD,MAAM;eAAS,OAAO;gBAAU,MAAM;;;;;;kBAEvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;0BAAoB,OAAO,EAAE;2BAAqB,OAAO,EAAE;oBAAc,OAAO,EAAE"}

package/dist/cli/commands/init.mjs

@@ -14,6 +14,7 @@
  * byte-for-byte from the previous implementation. Only the runtime-install
  * half is replaced.
  */
+import { execSync } from 'node:child_process';
 import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, } from 'node:fs';
 import { basename, dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -191,6 +192,52 @@ function buildRerunWithHint(projectDir, parsedFlags, requiresExplicit) {
     }
     return `apt-tools init ${projectDir} ${flags.join(' ')}`.trim();
 }
+/**
+ * Infer `share.visibility` from the target's git tracking state.
+ *
+ * Repos that already track files inside `.aperant/` or any runtime root
+ * (`.claude/`, `.codex/`, …) are *behaviourally* team-mode: contributors
+ * pull the framework's installed files via git, not via local
+ * `apt-tools init`. Treating them as solo on an upgrade (the old `--yes`
+ * default did exactly this — bumped the schema, silently wrote
+ * `visibility: 'solo'`, and the project-gitignore allow-list flipped)
+ * is a destructive, non-obvious surprise. The 0.6.0/0.6.1 dogfood
+ * incidents both hit this rake.
+ *
+ * Returns:
+ *   - `'team'` when any tracked file lives under `.aperant/` or a runtime
+ *     root.
+ *   - `'solo'` when the dir is a git repo but no such tracked file
+ *     exists.
+ *   - `undefined` when the target isn't a git repo (caller falls back to
+ *     the descriptor default, which preserves greenfield behaviour).
+ *
+ * @param {string} targetDir
+ * @returns {'team'|'solo'|undefined}
+ */
+function inferVisibilityFromGit(targetDir) {
+    try {
+        execSync('git rev-parse --is-inside-work-tree 2>/dev/null', {
+            cwd: targetDir,
+            stdio: ['ignore', 'ignore', 'ignore'],
+        });
+    }
+    catch {
+        return undefined;
+    }
+    const probePaths = ['.aperant', ...RUNTIMES.map((r) => r.installRoot)];
+    try {
+        const out = execSync(`git ls-files -- ${probePaths.map((p) => `'${p}'`).join(' ')}`, {
+            cwd: targetDir,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        return out.length > 0 ? 'team' : 'solo';
+    }
+    catch {
+        return 'solo';
+    }
+}
 /**
  * Apply Class A defaults that were collapsed under --yes /
  * --accept-new-defaults back into the migrated config so finishInit
@@ -212,22 +259,31 @@ function buildRerunWithHint(projectDir, parsedFlags, requiresExplicit) {
  * writes — keeps the prototype-pollution guard and dot-path semantics in
  * one place.
  *
+ * `overrides` lets callers substitute the descriptor default for a
+ * specific shortKey — used in the upgrade path to honour
+ * `inferVisibilityFromGit`, so a team repo that ran `--yes` doesn't get
+ * silently flipped to solo.
+ *
  * @param {{ migrated: Record<string, unknown>, applied_defaults: Array<{ key: string, value: unknown, why: string, source?: string }> }} migration
  * @param {Array<{ key: string, why: string, default?: unknown }>} collapsedEntries
  * @param {string} source              `--yes` or `--accept-new-defaults`.
  * @param {unknown} templateVersion    Template's version, applied to migrated.
+ * @param {Record<string, unknown>} [overrides]  shortKey → inferred value.
  */
-function applyCollapsedClassAToMigration(migration, collapsedEntries, source, templateVersion) {
+function applyCollapsedClassAToMigration(migration, collapsedEntries, source, templateVersion, overrides = {}) {
     for (const r of collapsedEntries) {
         const desc = findClassDescriptor(r.key);
         if (!desc)
             continue;
-        setAt(migration.migrated, desc.key, desc.default);
+        const hasOverride = Object.hasOwn(overrides, desc.shortKey);
+        const value = hasOverride ? overrides[desc.shortKey] : desc.default;
+        const recordedSource = hasOverride ? `${source} (inferred from git tracking)` : source;
+        setAt(migration.migrated, desc.key, value);
         migration.applied_defaults.push({
             key: desc.shortKey,
-            value: desc.default,
+            value,
             why: r.why,
-            source,
+            source: recordedSource,
         });
     }
     if (templateVersion !== undefined) {
@@ -284,7 +340,19 @@ function nonInteractiveAnswers(targetDir, canonicalRoot, archetype, parsedFlags)
         // solo-mode — re-introducing the 0.6.0 dogfood bug.
         let requires = migration.requires_explicit;
         if (parsedFlags.yes && requires.length > 0) {
-            applyCollapsedClassAToMigration(migration, requires, '--yes', templateConfig.version);
+            // Prefer evidence over descriptor defaults: a repo that already
+            // tracks `.aperant/` or any runtime root is team-mode by
+            // behaviour. Without this, `--yes` flips long-tracked repos to
+            // solo on the v3→v4 schema bump (0.6.0/0.6.1 dogfood incidents).
+            // Explicit --solo/--team in parsedFlags wins; only collapse-time
+            // inference runs here.
+            const overrides = {};
+            if (!parsedFlags.visibility && requires.some((r) => r.key === 'visibility')) {
+                const inferred = inferVisibilityFromGit(targetDir);
+                if (inferred !== undefined)
+                    overrides.visibility = inferred;
+            }
+            applyCollapsedClassAToMigration(migration, requires, '--yes', templateConfig.version, overrides);
             requires = [];
         }
         else if (parsedFlags.accept_new_defaults && requires.length > 0) {