@aperant/framework 0.8.7 → 0.10.0

package/dist/cli/install/runtime-detect.d.mts

@@ -42,6 +42,18 @@ export function detectInstalledRuntimes(targetDir: string): RuntimeDescriptor[];
  *                                  capitalized form of `id`. Use for runtimes
  *                                  whose product branding differs from the
  *                                  internal id (C58: `kilo` → "Kilo Code").
+ * @property {string|null} nativeInstructionFile
+ *                                  The root-level instruction file this
+ *                                  runtime's native CLI reads (e.g. `claude`
+ *                                  reads `CLAUDE.md`, `codex` reads
+ *                                  `AGENTS.md`). `init` stamps the
+ *                                  `<!-- APT:framework-* -->` managed block
+ *                                  into every distinct non-null target for the
+ *                                  selected runtimes. `null` means the runtime
+ *                                  installs to its own surface (e.g. cursor →
+ *                                  `.cursor/rules`), NOT a root `.md` — `init`
+ *                                  skips null entries. Nullable by design, not
+ *                                  a future-work placeholder (ID-01).
  */
 /** @type {RuntimeDescriptor[]} */
 export const RUNTIMES: RuntimeDescriptor[];
@@ -82,5 +94,20 @@ export type RuntimeDescriptor = {
      * internal id (C58: `kilo` → "Kilo Code").
      */
     displayLabel?: string | undefined;
+    /**
+     *                                  The root-level instruction file this
+     *                                  runtime's native CLI reads (e.g. `claude`
+     *                                  reads `CLAUDE.md`, `codex` reads
+     *                                  `AGENTS.md`). `init` stamps the
+     *                                  `<!-- APT:framework-* -->` managed block
+     *                                  into every distinct non-null target for the
+     *                                  selected runtimes. `null` means the runtime
+     *                                  installs to its own surface (e.g. cursor →
+     *                                  `.cursor/rules`), NOT a root `.md` — `init`
+     *                                  skips null entries. Nullable by design, not
+     *                                  a future-work placeholder (ID-01).
+     */
+    nativeInstructionFile: string | null;
 };
+export { detectFromPackageJson, loadRuntimeCapabilities } from "../util/runtime-capabilities.mjs";
 //# sourceMappingURL=runtime-detect.d.mts.map

package/dist/cli/install/runtime-detect.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-detect.d.mts","sourceRoot":"","sources":["../../../src/cli/install/runtime-detect.mjs"],"names":[],"mappings":"AA4JA;;;;;GAKG;AACH,+BAHW,MAAM,GACJ,iBAAiB,GAAC,IAAI,CAIlC;AAED;;;;;;;;;GASG;AACH,2CAHW,MAAM,GACJ,MAAM,EAAE,CAcpB;AAED;;;;;;GAMG;AACH,mDAHW,MAAM,GACJ,iBAAiB,EAAE,CAc/B;AA7LD;;;;;;;;;;;;;;;;;;GAkBG;AAEH,kCAAkC;AAClC,uBADW,iBAAiB,EAAE,CA+G5B;AAEF,0BAA0B;AAC1B,0BADW,GAAG,CAAC,MAAM,CAAC,CACuC;;;;;QApI/C,MAAM;;;;UACN,MAAM;;;;;iBACN,MAAM;;;;;;aAEN,MAAM,EAAE;;;;;;;WAGR,MAAM,GAAC,IAAI"}
+{"version":3,"file":"runtime-detect.d.mts","sourceRoot":"","sources":["../../../src/cli/install/runtime-detect.mjs"],"names":[],"mappings":"AAgMA;;;;;GAKG;AACH,+BAHW,MAAM,GACJ,iBAAiB,GAAC,IAAI,CAIlC;AAED;;;;;;;;;GASG;AACH,2CAHW,MAAM,GACJ,MAAM,EAAE,CAcpB;AAED;;;;;;GAMG;AACH,mDAHW,MAAM,GACJ,iBAAiB,EAAE,CAc/B;AAxND;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,kCAAkC;AAClC,uBADW,iBAAiB,EAAE,CA8H5B;AAEF,0BAA0B;AAC1B,0BADW,GAAG,CAAC,MAAM,CAAC,CACuC;;;;;QA/J/C,MAAM;;;;UACN,MAAM;;;;;iBACN,MAAM;;;;;;aAEN,MAAM,EAAE;;;;;;;WAGR,MAAM,GAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;2BASX,MAAM,GAAC,IAAI"}

package/dist/cli/install/runtime-detect.mjs

@@ -16,6 +16,11 @@
 import { existsSync, statSync } from 'node:fs';
 import { join } from 'node:path';
 import { MANIFEST_FILENAME } from './manifest.mjs';
+// Package.json-shape capability detection lives in util/ (shared with
+// verify-proof/runtime-detect.mjs). Re-exported here so install-layer callers
+// (e.g. install/mcp-provision.mjs) consume it from their OWN layer instead of
+// reaching across into verify-proof/.
+export { detectFromPackageJson, loadRuntimeCapabilities, } from '../util/runtime-capabilities.mjs';
 /**
  * @typedef {Object} RuntimeDescriptor
  * @property {string} id            Stable identifier (`claude`, `cursor`, …).
@@ -34,6 +39,18 @@ import { MANIFEST_FILENAME } from './manifest.mjs';
  *                                  capitalized form of `id`. Use for runtimes
  *                                  whose product branding differs from the
  *                                  internal id (C58: `kilo` → "Kilo Code").
+ * @property {string|null} nativeInstructionFile
+ *                                  The root-level instruction file this
+ *                                  runtime's native CLI reads (e.g. `claude`
+ *                                  reads `CLAUDE.md`, `codex` reads
+ *                                  `AGENTS.md`). `init` stamps the
+ *                                  `<!-- APT:framework-* -->` managed block
+ *                                  into every distinct non-null target for the
+ *                                  selected runtimes. `null` means the runtime
+ *                                  installs to its own surface (e.g. cursor →
+ *                                  `.cursor/rules`), NOT a root `.md` — `init`
+ *                                  skips null entries. Nullable by design, not
+ *                                  a future-work placeholder (ID-01).
  */
 /** @type {RuntimeDescriptor[]} */
 export const RUNTIMES = Object.freeze([
@@ -43,6 +60,7 @@ export const RUNTIMES = Object.freeze([
         installRoot: '.claude',
         markers: ['.claude/settings.json', '.claude/settings.local.json'],
         cliId: 'claude-code',
+        nativeInstructionFile: 'CLAUDE.md',
     },
     {
         id: 'codex',
@@ -50,6 +68,7 @@ export const RUNTIMES = Object.freeze([
         installRoot: '.agents',
         markers: ['.codex/config.toml'],
         cliId: 'codex',
+        nativeInstructionFile: 'AGENTS.md',
     },
     {
         id: 'cursor',
@@ -57,6 +76,7 @@ export const RUNTIMES = Object.freeze([
         installRoot: '.cursor',
         markers: ['.cursor/settings.json'],
         cliId: 'cursor',
+        nativeInstructionFile: null,
     },
     {
         id: 'gemini',
@@ -64,6 +84,7 @@ export const RUNTIMES = Object.freeze([
         installRoot: '.gemini',
         markers: ['.gemini/settings.json'],
         cliId: 'gemini-cli',
+        nativeInstructionFile: 'GEMINI.md',
     },
     {
         id: 'opencode',
@@ -71,6 +92,7 @@ export const RUNTIMES = Object.freeze([
         installRoot: '.opencode',
         markers: ['.opencode/config.json'],
         cliId: 'opencode',
+        nativeInstructionFile: 'AGENTS.md',
     },
     {
         id: 'pi',
@@ -78,6 +100,7 @@ export const RUNTIMES = Object.freeze([
         installRoot: '.pi',
         markers: ['.pi/settings.json', '.pi/skills', '.pi/prompts'],
         cliId: 'pi',
+        nativeInstructionFile: null,
     },
     {
         id: 'kilo',
@@ -89,6 +112,7 @@ export const RUNTIMES = Object.freeze([
         // migration per spec ID-01). `--kilocode` is also accepted as a
         // deprecated alias of `--kilo` at the CLI flag parser layer.
         displayLabel: 'Kilo Code',
+        nativeInstructionFile: null,
     },
     {
         id: 'copilot',
@@ -96,6 +120,7 @@ export const RUNTIMES = Object.freeze([
         installRoot: '.github/copilot',
         markers: ['.github/copilot-instructions.md'],
         cliId: 'copilot',
+        nativeInstructionFile: null,
     },
     {
         id: 'antigravity',
@@ -103,6 +128,7 @@ export const RUNTIMES = Object.freeze([
         installRoot: '.antigravity',
         markers: ['.antigravity/config.json'],
         cliId: 'antigravity',
+        nativeInstructionFile: null,
     },
     {
         id: 'windsurf',
@@ -110,6 +136,7 @@ export const RUNTIMES = Object.freeze([
         installRoot: '.windsurf',
         markers: ['.windsurfrules'],
         cliId: 'windsurf',
+        nativeInstructionFile: null,
     },
     {
         id: 'augment',
@@ -117,6 +144,7 @@ export const RUNTIMES = Object.freeze([
         installRoot: '.augment',
         markers: ['.augment/config.json'],
         cliId: 'augment',
+        nativeInstructionFile: null,
     },
     {
         id: 'trae',
@@ -124,6 +152,7 @@ export const RUNTIMES = Object.freeze([
         installRoot: '.trae',
         markers: ['.trae/config.json'],
         cliId: 'trae',
+        nativeInstructionFile: null,
     },
     {
         id: 'qwen',
@@ -131,6 +160,7 @@ export const RUNTIMES = Object.freeze([
         installRoot: '.qwen',
         markers: ['.qwen/config.json'],
         cliId: 'qwen',
+        nativeInstructionFile: null,
     },
     {
         id: 'cline',
@@ -138,6 +168,7 @@ export const RUNTIMES = Object.freeze([
         installRoot: '.cline',
         markers: ['.cline/config.json'],
         cliId: 'cline',
+        nativeInstructionFile: null,
     },
     {
         id: 'codebuddy',
@@ -145,6 +176,7 @@ export const RUNTIMES = Object.freeze([
         installRoot: '.codebuddy',
         markers: ['.codebuddy/config.json'],
         cliId: 'codebuddy',
+        nativeInstructionFile: null,
     },
 ]);
 /** @type {Set<string>} */

package/dist/cli/install/runtime-detect.mjs.map

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

package/dist/cli/install/toml-merge.d.mts

@@ -0,0 +1,40 @@
+/**
+ * Whether `existingToml` already declares a `[mcp_servers.<id>]` table.
+ * Matches the header at the start of a line (ignoring leading whitespace),
+ * permitting an optional TOML trailing comment (` # …`) after the header —
+ * a hand-authored `[mcp_servers.tauri] # my server` must still count as
+ * present, otherwise the upsert would append a DUPLICATE table and produce
+ * an unparseable config (two same-named tables). The id is taken literally
+ * (dotted-key TOML ids do not occur for our server ids — electron/tauri are
+ * bare) and regex-escaped defensively. A `#`-prefixed comment LINE that
+ * merely mentions the header is NOT a match (the header must be the first
+ * non-whitespace token).
+ *
+ * @param {string} existingToml
+ * @param {string} serverId
+ * @returns {boolean}
+ */
+export function hasMcpServerTable(existingToml: string, serverId: string): boolean;
+/**
+ * Upsert a `[mcp_servers.<id>]` table into a Codex config.toml string.
+ *
+ * TOFU (ID-05): if a `[mcp_servers.<id>]` table already exists, returns the
+ * input unchanged with `action: 'skipped'`. Otherwise appends the new table
+ * (and a nested `[mcp_servers.<id>.env]` table when `env` is non-empty) at
+ * EOF, preserving all existing content verbatim, and returns the new
+ * content with `action: 'written'`.
+ *
+ * @param {string} existingToml — current file contents ('' when the file is absent)
+ * @param {string} serverId
+ * @param {{command: string, args: string[], env?: Record<string, string>}} spec
+ * @returns {{content: string, action: 'written'|'skipped'}}
+ */
+export function upsertMcpServerToml(existingToml: string, serverId: string, spec: {
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+}): {
+    content: string;
+    action: "written" | "skipped";
+};
+//# sourceMappingURL=toml-merge.d.mts.map

package/dist/cli/install/toml-merge.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toml-merge.d.mts","sourceRoot":"","sources":["../../../src/cli/install/toml-merge.mjs"],"names":[],"mappings":"AA2DA;;;;;;;;;;;;;;;GAeG;AACH,gDAJW,MAAM,YACN,MAAM,GACJ,OAAO,CAanB;AAED;;;;;;;;;;;;;GAaG;AACH,kDALW,MAAM,YACN,MAAM,QACN;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAC,GAC7D;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,GAAC,SAAS,CAAA;CAAC,CAsC1D"}

package/dist/cli/install/toml-merge.mjs

@@ -0,0 +1,134 @@
+/**
+ * install/toml-merge.mjs — dependency-free minimal TOML upsert for the
+ * Codex MCP-server config table.
+ *
+ * Codex's MCP config lives at project-root `.codex/config.toml` as:
+ *
+ *   [mcp_servers.<id>]
+ *   command = "bash"
+ *   args = ["./scripts/tauri-mcp.sh"]
+ *
+ *   [mcp_servers.<id>.env]
+ *   FOO = "bar"
+ *
+ * No TOML serializer ships in the framework and `@iarna/toml` is not a
+ * dependency, so we hand-roll the MINIMAL upsert covering ONLY this shape
+ * (string command, string[] args, optional nested env table of
+ * string=string). Presence is detected by scanning for the
+ * `[mcp_servers.<id>]` header line; if present, we SKIP unchanged (TOFU
+ * per ID-05) — never diff/merge/overwrite a hand-authored table. All other
+ * content is preserved verbatim; the new table block is appended at EOF.
+ *
+ * Pure module — string in, string out.
+ */
+/**
+ * Escape a string for a TOML basic (double-quoted) string. Only the
+ * characters that can occur in a command/arg/env value: backslash and
+ * double-quote.
+ *
+ * @param {string} s
+ * @returns {string}
+ */
+function tomlString(s) {
+    return `"${String(s).replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+}
+/**
+ * Render a TOML array of double-quoted strings: `["a", "b"]`.
+ *
+ * @param {string[]} arr
+ * @returns {string}
+ */
+function tomlStringArray(arr) {
+    return `[${arr.map((a) => tomlString(a)).join(', ')}]`;
+}
+/**
+ * Render a TOML key. A bare key (TOML `[A-Za-z0-9_-]+`) is emitted verbatim;
+ * any other key is quoted as a TOML basic string so a non-bare env name
+ * (e.g. one containing `.`, a space, or `"`) cannot break the table or inject
+ * extra structure.
+ *
+ * @param {string} key
+ * @returns {string}
+ */
+function tomlKey(key) {
+    return /^[A-Za-z0-9_-]+$/.test(key) ? key : tomlString(key);
+}
+/**
+ * Whether `existingToml` already declares a `[mcp_servers.<id>]` table.
+ * Matches the header at the start of a line (ignoring leading whitespace),
+ * permitting an optional TOML trailing comment (` # …`) after the header —
+ * a hand-authored `[mcp_servers.tauri] # my server` must still count as
+ * present, otherwise the upsert would append a DUPLICATE table and produce
+ * an unparseable config (two same-named tables). The id is taken literally
+ * (dotted-key TOML ids do not occur for our server ids — electron/tauri are
+ * bare) and regex-escaped defensively. A `#`-prefixed comment LINE that
+ * merely mentions the header is NOT a match (the header must be the first
+ * non-whitespace token).
+ *
+ * @param {string} existingToml
+ * @param {string} serverId
+ * @returns {boolean}
+ */
+export function hasMcpServerTable(existingToml, serverId) {
+    if (typeof existingToml !== 'string' || existingToml.length === 0)
+        return false;
+    const escapedId = serverId.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    // `[mcp_servers.<id>]` at line start (after optional indent), optionally
+    // followed by whitespace and/or a `#` trailing comment, to EOL.
+    const headerRe = new RegExp(`^\\s*\\[mcp_servers\\.${escapedId}\\]\\s*(#.*)?$`);
+    const lines = existingToml.split(/\r?\n/);
+    for (const line of lines) {
+        if (headerRe.test(line))
+            return true;
+    }
+    return false;
+}
+/**
+ * Upsert a `[mcp_servers.<id>]` table into a Codex config.toml string.
+ *
+ * TOFU (ID-05): if a `[mcp_servers.<id>]` table already exists, returns the
+ * input unchanged with `action: 'skipped'`. Otherwise appends the new table
+ * (and a nested `[mcp_servers.<id>.env]` table when `env` is non-empty) at
+ * EOF, preserving all existing content verbatim, and returns the new
+ * content with `action: 'written'`.
+ *
+ * @param {string} existingToml — current file contents ('' when the file is absent)
+ * @param {string} serverId
+ * @param {{command: string, args: string[], env?: Record<string, string>}} spec
+ * @returns {{content: string, action: 'written'|'skipped'}}
+ */
+export function upsertMcpServerToml(existingToml, serverId, spec) {
+    const existing = typeof existingToml === 'string' ? existingToml : '';
+    if (hasMcpServerTable(existing, serverId)) {
+        return { content: existing, action: 'skipped' };
+    }
+    const lines = [];
+    lines.push(`[mcp_servers.${serverId}]`);
+    lines.push(`command = ${tomlString(spec.command)}`);
+    lines.push(`args = ${tomlStringArray(spec.args ?? [])}`);
+    const env = spec.env && typeof spec.env === 'object' ? spec.env : null;
+    const envKeys = env ? Object.keys(env) : [];
+    if (envKeys.length > 0) {
+        lines.push('');
+        lines.push(`[mcp_servers.${serverId}.env]`);
+        for (const key of envKeys) {
+            lines.push(`${tomlKey(key)} = ${tomlString(env[key])}`);
+        }
+    }
+    const block = lines.join('\n');
+    // Preserve existing content; separate the new block with exactly one blank
+    // line. An empty existing file yields just the block + trailing newline.
+    // Strip the existing file's trailing newline run first so a file that
+    // already ends in a blank line (`…\n\n`) does not produce a DOUBLE blank
+    // line before the appended block.
+    let content;
+    if (existing.trim().length === 0) {
+        content = `${block}\n`;
+    }
+    else {
+        const head = existing.replace(/\n+$/, '');
+        content = `${head}\n\n${block}\n`;
+    }
+    return { content, action: 'written' };
+}
+//# sourceMappingURL=toml-merge.mjs.map

package/dist/cli/install/toml-merge.mjs.map

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

package/dist/cli/util/aperant-section.d.mts

@@ -31,4 +31,16 @@ export function buildAptSection({ canonicalRoot, targetDir, cli }: {
  * @returns {string[]}    Row IDs in file order, e.g. `['/apt', '/apt:quick', …]`.
  */
 export function extractAptSectionRowIds(text: string): string[];
+/**
+ * Matches the full APT managed block (start marker through end marker,
+ * inclusive). Exported so callers in the same package can reference a
+ * single source rather than inlining duplicate regex literals.
+ *
+ * `APT_SECTION_RE`       — no trailing newline; used for in-place replace.
+ * `APT_SECTION_STRIP_RE` — includes optional trailing newline; used for
+ *                          strip operations that want to remove the newline
+ *                          the block was preceded/followed by.
+ */
+export const APT_SECTION_RE: RegExp;
+export const APT_SECTION_STRIP_RE: RegExp;
 //# sourceMappingURL=aperant-section.d.mts.map

package/dist/cli/util/aperant-section.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"aperant-section.d.mts","sourceRoot":"","sources":["../../../src/cli/util/aperant-section.mjs"],"names":[],"mappings":"AAuDA;;;;;;;;;;;;;;;GAeG;AACH,mEAXG;IAAqB,aAAa,EAA1B,MAAM;IAGO,SAAS,EAAtB,MAAM;IACQ,GAAG;CAGzB,GAAU,MAAM,CAqClB;AAED;;;;;;;;;;GAUG;AACH,8CAHW,MAAM,GACJ,MAAM,EAAE,CAoBpB"}
+{"version":3,"file":"aperant-section.d.mts","sourceRoot":"","sources":["../../../src/cli/util/aperant-section.mjs"],"names":[],"mappings":"AAqEA;;;;;;;;;;;;;;;GAeG;AACH,mEAXG;IAAqB,aAAa,EAA1B,MAAM;IAGO,SAAS,EAAtB,MAAM;IACQ,GAAG;CAGzB,GAAU,MAAM,CAqClB;AAED;;;;;;;;;;GAUG;AACH,8CAHW,MAAM,GACJ,MAAM,EAAE,CAoBpB;AA5HD;;;;;;;;;GASG;AACH,oCAA8F;AAC9F,0CACoE"}

package/dist/cli/util/aperant-section.mjs

@@ -20,6 +20,18 @@ import { getTrustedSkillSources } from '../config/load.mjs';
 import { discoverSkills } from '../route/skill-discover.mjs';
 const SECTION_START = '<!-- APT:framework-start -->';
 const SECTION_END = '<!-- APT:framework-end -->';
+/**
+ * Matches the full APT managed block (start marker through end marker,
+ * inclusive). Exported so callers in the same package can reference a
+ * single source rather than inlining duplicate regex literals.
+ *
+ * `APT_SECTION_RE`       — no trailing newline; used for in-place replace.
+ * `APT_SECTION_STRIP_RE` — includes optional trailing newline; used for
+ *                          strip operations that want to remove the newline
+ *                          the block was preceded/followed by.
+ */
+export const APT_SECTION_RE = /<!-- APT:framework-start -->[\s\S]*?<!-- APT:framework-end -->/;
+export const APT_SECTION_STRIP_RE = /<!-- APT:framework-start -->[\s\S]*?<!-- APT:framework-end -->\n?/;
 const SECTION_HEADING = '## Aperant Framework';
 const APPENDIX_REL_PATH = ['templates', 'aperant-claude-md-appendix.md'];
 /**

package/dist/cli/util/aperant-section.mjs.map

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

package/dist/cli/util/copy.d.mts

@@ -1,4 +1,31 @@
 export function copyDirRecursive(src: any, dest: any): void;
+/**
+ * Preflight-only sibling of `injectInstructionFile`. Runs the same
+ * foreign-row defensive check against `filePath` but NEVER writes — used by
+ * the multi-target init flow to check every instruction target up-front so a
+ * single aborting target leaves NO file partially written (US-03 / AC3).
+ *
+ * Returns the same status vocabulary as `injectInstructionFile` minus the
+ * write side-effect: `'created'` (file absent → would be appended-to),
+ * `'updated'` (markers present, no foreign rows → would be replaced),
+ * `'aborted-foreign-rows'` (markers present with rows not in the generated
+ * set → init must abort). `force` short-circuits the foreign-row gate exactly
+ * as the writer does.
+ *
+ * @param {string} filePath
+ * @param {Object} opts
+ * @param {string} opts.aptSection   Output of buildAptSection().
+ * @param {boolean} [opts.force=false]
+ *                                    Bypass the foreign-row check.
+ * @returns {{ status: 'created' | 'updated' | 'aborted-foreign-rows', foreignRowIds?: string[] }}
+ */
+export function checkInstructionFile(filePath: string, { aptSection, force }: {
+    aptSection: string;
+    force?: boolean | undefined;
+}): {
+    status: "created" | "updated" | "aborted-foreign-rows";
+    foreignRowIds?: string[];
+};
 /**
  * Write the (already-generated) APT section into `filePath`. Creates the
  * file if missing; replaces the section in-place if the markers are

package/dist/cli/util/copy.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"copy.d.mts","sourceRoot":"","sources":["../../../src/cli/util/copy.mjs"],"names":[],"mappings":"AAwBA,4DAWC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,gDARW,MAAM,yBAEd;IAAqB,UAAU,EAAvB,MAAM;IAES,KAAK;CAE5B,GAAU;IAAE,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,sBAAsB,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CA0BlH"}
+{"version":3,"file":"copy.d.mts","sourceRoot":"","sources":["../../../src/cli/util/copy.mjs"],"names":[],"mappings":"AAsCA,4DAWC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,+CAPW,MAAM,yBAEd;IAAqB,UAAU,EAAvB,MAAM;IACS,KAAK;CAE5B,GAAU;IAAE,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,sBAAsB,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAgBhG;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,gDARW,MAAM,yBAEd;IAAqB,UAAU,EAAvB,MAAM;IAES,KAAK;CAE5B,GAAU;IAAE,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,sBAAsB,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAqBlH"}

package/dist/cli/util/copy.mjs

@@ -12,7 +12,20 @@
  */
 import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, } from 'node:fs';
 import { join } from 'node:path';
-import { extractAptSectionRowIds } from './aperant-section.mjs';
+import { APT_SECTION_RE, extractAptSectionRowIds } from './aperant-section.mjs';
+/**
+ * Return the row IDs present in `existing` that are NOT present in
+ * `aptSection`. An empty array means no foreign rows (safe to overwrite).
+ *
+ * @param {string} existing   Current on-disk file contents.
+ * @param {string} aptSection Output of buildAptSection().
+ * @returns {string[]}
+ */
+function computeForeignRowIds(existing, aptSection) {
+    const existingIds = new Set(extractAptSectionRowIds(existing));
+    const generatedIds = new Set(extractAptSectionRowIds(aptSection));
+    return [...existingIds].filter((id) => !generatedIds.has(id));
+}
 export function copyDirRecursive(src, dest) {
     mkdirSync(dest, { recursive: true });
     for (const entry of readdirSync(src, { withFileTypes: true })) {
@@ -26,6 +39,39 @@ export function copyDirRecursive(src, dest) {
         }
     }
 }
+/**
+ * Preflight-only sibling of `injectInstructionFile`. Runs the same
+ * foreign-row defensive check against `filePath` but NEVER writes — used by
+ * the multi-target init flow to check every instruction target up-front so a
+ * single aborting target leaves NO file partially written (US-03 / AC3).
+ *
+ * Returns the same status vocabulary as `injectInstructionFile` minus the
+ * write side-effect: `'created'` (file absent → would be appended-to),
+ * `'updated'` (markers present, no foreign rows → would be replaced),
+ * `'aborted-foreign-rows'` (markers present with rows not in the generated
+ * set → init must abort). `force` short-circuits the foreign-row gate exactly
+ * as the writer does.
+ *
+ * @param {string} filePath
+ * @param {Object} opts
+ * @param {string} opts.aptSection   Output of buildAptSection().
+ * @param {boolean} [opts.force=false]
+ *                                    Bypass the foreign-row check.
+ * @returns {{ status: 'created' | 'updated' | 'aborted-foreign-rows', foreignRowIds?: string[] }}
+ */
+export function checkInstructionFile(filePath, { aptSection, force = false }) {
+    const existing = existsSync(filePath) ? readFileSync(filePath, 'utf-8') : '';
+    if (existing.includes('<!-- APT:framework-start -->')) {
+        if (!force) {
+            const foreignRowIds = computeForeignRowIds(existing, aptSection);
+            if (foreignRowIds.length > 0) {
+                return { status: 'aborted-foreign-rows', foreignRowIds };
+            }
+        }
+        return { status: 'updated' };
+    }
+    return { status: 'created' };
+}
 /**
  * Write the (already-generated) APT section into `filePath`. Creates the
  * file if missing; replaces the section in-place if the markers are
@@ -50,14 +96,12 @@ export function injectInstructionFile(filePath, { aptSection, force = false }) {
     const existing = existsSync(filePath) ? readFileSync(filePath, 'utf-8') : '';
     if (existing.includes('<!-- APT:framework-start -->')) {
         if (!force) {
-            const existingIds = new Set(extractAptSectionRowIds(existing));
-            const generatedIds = new Set(extractAptSectionRowIds(aptSection));
-            const foreignRowIds = [...existingIds].filter((id) => !generatedIds.has(id));
+            const foreignRowIds = computeForeignRowIds(existing, aptSection);
             if (foreignRowIds.length > 0) {
                 return { status: 'aborted-foreign-rows', written: false, foreignRowIds };
             }
         }
-        const updated = existing.replace(/<!-- APT:framework-start -->[\s\S]*?<!-- APT:framework-end -->/, aptSection);
+        const updated = existing.replace(APT_SECTION_RE, aptSection);
         writeFileSync(filePath, updated, 'utf-8');
         return { status: 'updated', written: true };
     }

package/dist/cli/util/copy.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"copy.mjs","sourceRoot":"","sources":["../../../src/cli/util/copy.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACN,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,YAAY,EACZ,aAAa,GACb,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAE/D,MAAM,UAAU,gBAAgB,CAAC,GAAG,EAAE,IAAI;IACzC,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACpC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;QACvC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACzB,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;QACpC,CAAC;aAAM,CAAC;YACP,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;QAChC,CAAC;IACF,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,KAAK,GAAG,KAAK,EAAE;IAC5E,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAE5E,IAAI,QAAQ,CAAC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC,KAAK,EAAE,CAAC;YACZ,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,CAAA;YAC9D,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC,CAAA;YACjE,MAAM,aAAa,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;YAC5E,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,OAAO,EAAE,MAAM,EAAE,sBAAsB,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAA;YACzE,CAAC;QACF,CAAC;QACD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAC/B,gEAAgE,EAChE,UAAU,CACV,CAAA;QACD,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;QACzC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC5C,CAAC;IAED,uDAAuD;IACvD,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;IACnD,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,IAAI,EAAE,OAAO,CAAC,CAAA;IAC1E,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;AAC5C,CAAC"}
+{"version":3,"file":"copy.mjs","sourceRoot":"","sources":["../../../src/cli/util/copy.mjs"],"names":[],"mappings":"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"}

package/dist/cli/util/events-path.d.mts

@@ -0,0 +1,8 @@
+/**
+ * Compute today's events filename relative to projectDir.
+ * @param {string} projectDir
+ * @param {Date} [now]
+ * @returns {string}
+ */
+export function dailyEventsPath(projectDir: string, now?: Date): string;
+//# sourceMappingURL=events-path.d.mts.map

package/dist/cli/util/events-path.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-path.d.mts","sourceRoot":"","sources":["../../../src/cli/util/events-path.mjs"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,4CAJW,MAAM,QACN,IAAI,GACF,MAAM,CAOlB"}

package/dist/cli/util/events-path.mjs

@@ -0,0 +1,23 @@
+/**
+ * util/events-path.mjs — canonical path computation for the per-day event
+ * log at `.aperant/events/{YYYY-MM-DD}.jsonl` (ID-05).
+ *
+ * Lives in util/ so both the install layer (install/mcp-provision.mjs) and the
+ * verify-proof layer (verify-proof/audit.mjs) compute the same path WITHOUT
+ * install/ importing from verify-proof/ (the layer-boundary rule). Pure
+ * function — no fs, no exec.
+ */
+import { join, resolve } from 'node:path';
+/**
+ * Compute today's events filename relative to projectDir.
+ * @param {string} projectDir
+ * @param {Date} [now]
+ * @returns {string}
+ */
+export function dailyEventsPath(projectDir, now = new Date()) {
+    const yyyy = now.getUTCFullYear();
+    const mm = String(now.getUTCMonth() + 1).padStart(2, '0');
+    const dd = String(now.getUTCDate()).padStart(2, '0');
+    return join(resolve(projectDir), '.aperant/events', `${yyyy}-${mm}-${dd}.jsonl`);
+}
+//# sourceMappingURL=events-path.mjs.map

package/dist/cli/util/events-path.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-path.mjs","sourceRoot":"","sources":["../../../src/cli/util/events-path.mjs"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEzC;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,UAAU,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE;IAC3D,MAAM,IAAI,GAAG,GAAG,CAAC,cAAc,EAAE,CAAA;IACjC,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACzD,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACpD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,iBAAiB,EAAE,GAAG,IAAI,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;AACjF,CAAC"}