ctxr-cli 0.1.0

package/dist/core/errors.js

@@ -0,0 +1,267 @@
+import { ExitCode } from './exit-codes.js';
+/**
+ * Base for every error contexture raises deliberately (as opposed to a bug,
+ * which throws something else and is mapped to ExitCode.Internal). Each
+ * carries the finding that explains, in the fail-loud contract's terms,
+ * exactly what could not be determined — never a guessed fallback.
+ */
+export class ContextureError extends Error {
+    exitCode;
+    finding;
+    constructor(exitCode, finding) {
+        super(finding.message);
+        this.name = new.target.name;
+        this.exitCode = exitCode;
+        this.finding = finding;
+    }
+}
+export class NoStoreRootError extends ContextureError {
+    constructor(checked) {
+        super(ExitCode.Usage, {
+            code: 'root.not_found',
+            severity: 'error',
+            message: 'No store root found: checked --root, CONTEXTURE_ROOT, and walking up ' +
+                `from "${checked.cwd}" looking for contexture.yaml.`,
+            details: { checkedFlag: checked.flag, checkedEnv: checked.env, cwd: checked.cwd },
+        });
+    }
+}
+export class NotAGitRepositoryError extends ContextureError {
+    constructor(root) {
+        super(ExitCode.Usage, {
+            code: 'root.not_a_git_repository',
+            severity: 'error',
+            message: `"${root}" is not inside a git repository.`,
+            subject: root,
+        });
+    }
+}
+export class SchemaVersionNewerError extends ContextureError {
+    constructor(storeVersion, supportedVersion) {
+        super(ExitCode.Usage, {
+            code: 'config.schema_version.newer',
+            severity: 'error',
+            message: `This store's schema_version (${storeVersion}) is newer than the ` +
+                `version this contexture release supports (${supportedVersion}).`,
+            details: { storeVersion, supportedVersion },
+        });
+    }
+}
+export class SchemaVersionMissingError extends ContextureError {
+    constructor(configPath) {
+        super(ExitCode.Usage, {
+            code: 'config.schema_version.missing',
+            severity: 'error',
+            message: `"${configPath}" has no schema_version field — this store predates ` +
+                'the schema-version requirement and must be migrated with an explicit tool.',
+            subject: configPath,
+        });
+    }
+}
+export class InvalidConfigError extends ContextureError {
+    constructor(configPath, issues) {
+        super(ExitCode.Usage, {
+            code: 'config.invalid',
+            severity: 'error',
+            message: `"${configPath}" failed validation: ${issues.map((i) => `${i.path}: ${i.message}`).join('; ')}`,
+            subject: configPath,
+            details: { issues },
+        });
+    }
+}
+export class InvalidNoteFrontmatterError extends ContextureError {
+    constructor(notePath, detail) {
+        super(ExitCode.Usage, {
+            code: 'note.invalid_frontmatter',
+            severity: 'error',
+            message: `"${notePath}" has a frontmatter block that is not valid: ${detail}.`,
+            subject: notePath,
+        });
+    }
+}
+export class SessionNotFoundError extends ContextureError {
+    constructor(branch) {
+        super(ExitCode.Usage, {
+            code: 'session.not_found',
+            severity: 'error',
+            message: `No session found for branch "${branch}".`,
+            subject: branch,
+        });
+    }
+}
+export class SessionValidationFailedError extends ContextureError {
+    constructor(findings) {
+        super(ExitCode.CheckFailed, {
+            code: 'session.validation_failed',
+            severity: 'error',
+            message: `Session validation failed: ${findings.map((f) => f.message).join('; ')}`,
+            details: { findings },
+        });
+    }
+}
+export class NoRemoteConfiguredError extends ContextureError {
+    constructor() {
+        super(ExitCode.Usage, {
+            code: 'session.no_remote',
+            severity: 'error',
+            message: 'No "origin" remote is configured; add one before submitting a session.',
+        });
+    }
+}
+export class CatalogSectionNotFoundError extends ContextureError {
+    constructor(sectionId) {
+        super(ExitCode.Usage, {
+            code: 'catalog.section_not_found',
+            severity: 'error',
+            message: `No catalog section named "${sectionId}".`,
+            subject: sectionId,
+        });
+    }
+}
+export class GraphIdentityCollisionError extends ContextureError {
+    constructor(ids) {
+        super(ExitCode.CheckFailed, {
+            code: 'graph.identity_collision',
+            severity: 'error',
+            message: `Two or more notes resolve to the same graph node identity: ${ids.join(', ')}. No graph artifact was written.`,
+            details: { ids },
+        });
+    }
+}
+export class NoteNotFoundError extends ContextureError {
+    constructor(notePath) {
+        super(ExitCode.Usage, {
+            code: 'note.not_found',
+            severity: 'error',
+            message: `"${notePath}" does not exist in this store.`,
+            subject: notePath,
+        });
+    }
+}
+export class AlreadyIngestedError extends ContextureError {
+    constructor(notePath) {
+        super(ExitCode.Usage, {
+            code: 'ingest.already_ingested',
+            severity: 'error',
+            message: `"${notePath}" already carries source-identity fields; ingest never re-stamps an already-ingested file.`,
+            subject: notePath,
+        });
+    }
+}
+export class NoteNotTrackedError extends ContextureError {
+    constructor(notePath) {
+        super(ExitCode.Usage, {
+            code: 'archive.not_tracked',
+            severity: 'error',
+            message: `Cannot archive "${notePath}": it is not yet tracked by git. Commit it first, then archive.`,
+            subject: notePath,
+        });
+    }
+}
+export class ArchiveDestinationExistsError extends ContextureError {
+    constructor(destinationPath) {
+        super(ExitCode.Usage, {
+            code: 'archive.destination_exists',
+            severity: 'error',
+            message: `Cannot archive: "${destinationPath}" already exists.`,
+            subject: destinationPath,
+        });
+    }
+}
+export class AdapterNotFoundError extends ContextureError {
+    constructor(kind, id) {
+        super(ExitCode.Usage, {
+            code: 'adapter.not_found',
+            severity: 'error',
+            message: `Configured adapter "${id}" (kind: ${kind}) is not a known adapter.`,
+            subject: id,
+            details: { kind },
+        });
+    }
+}
+export class AdapterVersionMismatchError extends ContextureError {
+    constructor(kind, id, declaredVersion, supportedVersion) {
+        super(ExitCode.Usage, {
+            code: 'adapter.version_mismatch',
+            severity: 'error',
+            message: `Adapter "${id}" (kind: ${kind}) declares interface version ${declaredVersion}, but this contexture release supports version ${supportedVersion}.`,
+            subject: id,
+            details: { kind, declaredVersion, supportedVersion },
+        });
+    }
+}
+export class GraphNotBuiltError extends ContextureError {
+    constructor() {
+        super(ExitCode.Usage, {
+            code: 'graph.not_built',
+            severity: 'error',
+            message: 'No graph artifact exists yet. Run "ctxr graph build" first.',
+        });
+    }
+}
+export class GraphNodeNotFoundError extends ContextureError {
+    constructor(nodeId) {
+        super(ExitCode.Usage, {
+            code: 'graph.node_not_found',
+            severity: 'error',
+            message: `"${nodeId}" is not a node in the graph.`,
+            subject: nodeId,
+        });
+    }
+}
+export class MarkerMismatchError extends ContextureError {
+    constructor(filePath, detail) {
+        super(ExitCode.Usage, {
+            code: 'fenced_region.marker_mismatch',
+            severity: 'error',
+            message: `"${filePath}" has a mismatched marker pair: ${detail}. No bytes were written.`,
+            subject: filePath,
+        });
+    }
+}
+export class GitIdentityMissingError extends ContextureError {
+    constructor() {
+        super(ExitCode.Usage, {
+            code: 'git.identity_missing',
+            severity: 'error',
+            message: 'git has no configured author identity. Run:\n' +
+                '  git config user.email "you@example.com"\n' +
+                '  git config user.name "Your Name"\n' +
+                'then re-run init.',
+        });
+    }
+}
+export class TaxonomySelectionConflictError extends ContextureError {
+    constructor() {
+        super(ExitCode.Usage, {
+            code: 'taxonomy.selection_conflict',
+            severity: 'error',
+            message: '--profile and --taxonomy were both given; pass exactly one.',
+        });
+    }
+}
+export class InvalidTaxonomyFileError extends ContextureError {
+    constructor(filePath, issues) {
+        super(ExitCode.Usage, {
+            code: 'taxonomy.invalid_file',
+            severity: 'error',
+            message: `"${filePath}" is not a valid taxonomy definition: ${issues
+                .map((i) => `${i.path}: ${i.message}`)
+                .join('; ')}`,
+            subject: filePath,
+            details: { issues },
+        });
+    }
+}
+export class UnknownTaxonomyProfileError extends ContextureError {
+    constructor(given, knownIds) {
+        super(ExitCode.Usage, {
+            code: 'taxonomy.unknown_profile',
+            severity: 'error',
+            message: `Unknown taxonomy profile "${given}". Known profiles: ${knownIds.join(', ')}.`,
+            subject: given,
+            details: { knownIds },
+        });
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

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

package/dist/core/exit-codes.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The exit-code taxonomy every contexture command shares (cli-contract spec).
+ *
+ * `0` and `1` follow a deliberate split from plain "success vs failure":
+ * Node itself exits a process with `1` on an uncaught exception, so `1` is
+ * reserved for exactly that class of failure (a bug, a crash) and nothing
+ * else. That keeps `1` from ever being confused with "the command ran
+ * correctly and found a real problem" — which is `CheckFailed`, not `Internal`.
+ *
+ * `4` and `5` are reserved now, unused until Phase 5's disclosure-policy
+ * tri-state (ALLOW/DENY/ASK) needs codes distinct from `CheckFailed` — ALLOW
+ * must be `Ok` (0), so DENY/ASK can't reuse `CheckFailed` (3).
+ *
+ * This table is allocated once, here, and is never extended by guessing a
+ * number under pressure in a later phase.
+ */
+export declare const ExitCode: {
+    /** The command ran and found nothing wrong. */
+    readonly Ok: 0;
+    /** An unexpected internal error (a bug) — never a real, expected finding. */
+    readonly Internal: 1;
+    /** Bad arguments, no store root, not a git repo, invalid/mismatched schema version. */
+    readonly Usage: 2;
+    /** The command ran correctly and determined a real problem exists. */
+    readonly CheckFailed: 3;
+    /** Reserved for Phase 5's disclosure-policy tri-state: DENY. */
+    readonly DisclosureDeny: 4;
+    /** Reserved for Phase 5's disclosure-policy tri-state: ASK. */
+    readonly DisclosureAsk: 5;
+};
+export type ExitCode = (typeof ExitCode)[keyof typeof ExitCode];
+//# sourceMappingURL=exit-codes.d.ts.map

package/dist/core/exit-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../../src/core/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,QAAQ;IACnB,+CAA+C;aAC/C,EAAE,EAAE,CAAC;IACL,6EAA6E;aAC7E,QAAQ,EAAE,CAAC;IACX,uFAAuF;aACvF,KAAK,EAAE,CAAC;IACR,sEAAsE;aACtE,WAAW,EAAE,CAAC;IACd,gEAAgE;aAChE,cAAc,EAAE,CAAC;IACjB,+DAA+D;aAC/D,aAAa,EAAE,CAAC;CACR,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC"}

package/dist/core/exit-codes.js

@@ -0,0 +1,31 @@
+/**
+ * The exit-code taxonomy every contexture command shares (cli-contract spec).
+ *
+ * `0` and `1` follow a deliberate split from plain "success vs failure":
+ * Node itself exits a process with `1` on an uncaught exception, so `1` is
+ * reserved for exactly that class of failure (a bug, a crash) and nothing
+ * else. That keeps `1` from ever being confused with "the command ran
+ * correctly and found a real problem" — which is `CheckFailed`, not `Internal`.
+ *
+ * `4` and `5` are reserved now, unused until Phase 5's disclosure-policy
+ * tri-state (ALLOW/DENY/ASK) needs codes distinct from `CheckFailed` — ALLOW
+ * must be `Ok` (0), so DENY/ASK can't reuse `CheckFailed` (3).
+ *
+ * This table is allocated once, here, and is never extended by guessing a
+ * number under pressure in a later phase.
+ */
+export const ExitCode = {
+    /** The command ran and found nothing wrong. */
+    Ok: 0,
+    /** An unexpected internal error (a bug) — never a real, expected finding. */
+    Internal: 1,
+    /** Bad arguments, no store root, not a git repo, invalid/mismatched schema version. */
+    Usage: 2,
+    /** The command ran correctly and determined a real problem exists. */
+    CheckFailed: 3,
+    /** Reserved for Phase 5's disclosure-policy tri-state: DENY. */
+    DisclosureDeny: 4,
+    /** Reserved for Phase 5's disclosure-policy tri-state: ASK. */
+    DisclosureAsk: 5,
+};
+//# sourceMappingURL=exit-codes.js.map

package/dist/core/exit-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../../src/core/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,+CAA+C;IAC/C,EAAE,EAAE,CAAC;IACL,6EAA6E;IAC7E,QAAQ,EAAE,CAAC;IACX,uFAAuF;IACvF,KAAK,EAAE,CAAC;IACR,sEAAsE;IACtE,WAAW,EAAE,CAAC;IACd,gEAAgE;IAChE,cAAc,EAAE,CAAC;IACjB,+DAA+D;IAC/D,aAAa,EAAE,CAAC;CACR,CAAC"}

package/dist/core/fs/atomic.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Writes `contents` to `filePath` atomically: write to a temp file in the
+ * SAME directory (so rename() is same-filesystem and therefore atomic on
+ * POSIX), fsync it, then rename over the target. A process killed mid-write
+ * leaves either the old complete file or nothing on disk — never a
+ * truncated target. Used for every authored file contexture writes,
+ * starting with `contexture.yaml` and `.gitignore` in `init`.
+ */
+export declare function writeFileAtomic(filePath: string, contents: string): Promise<void>;
+//# sourceMappingURL=atomic.d.ts.map

package/dist/core/fs/atomic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic.d.ts","sourceRoot":"","sources":["../../../src/core/fs/atomic.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBvF"}

package/dist/core/fs/atomic.js

@@ -0,0 +1,31 @@
+import { randomBytes } from 'node:crypto';
+import { open, rename, unlink } from 'node:fs/promises';
+import path from 'node:path';
+/**
+ * Writes `contents` to `filePath` atomically: write to a temp file in the
+ * SAME directory (so rename() is same-filesystem and therefore atomic on
+ * POSIX), fsync it, then rename over the target. A process killed mid-write
+ * leaves either the old complete file or nothing on disk — never a
+ * truncated target. Used for every authored file contexture writes,
+ * starting with `contexture.yaml` and `.gitignore` in `init`.
+ */
+export async function writeFileAtomic(filePath, contents) {
+    const dir = path.dirname(filePath);
+    const tempPath = path.join(dir, `.${path.basename(filePath)}.${randomBytes(6).toString('hex')}.tmp`);
+    const handle = await open(tempPath, 'w');
+    try {
+        await handle.writeFile(contents, 'utf8');
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+    try {
+        await rename(tempPath, filePath);
+    }
+    catch (err) {
+        await unlink(tempPath).catch(() => undefined);
+        throw err;
+    }
+}
+//# sourceMappingURL=atomic.js.map

package/dist/core/fs/atomic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic.js","sourceRoot":"","sources":["../../../src/core/fs/atomic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,QAAgB;IACtE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACrG,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC9C,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/core/fs/fenced-region.d.ts

@@ -0,0 +1,47 @@
+import type { Fence } from '../markers.js';
+/**
+ * The marker-fence primitive (context-store spec), pulled forward from
+ * Phase 1.3 into its final home: `.gitignore`'s derived-path block is the
+ * first consumer, and every later generated-region writer (catalog, rollup,
+ * adapters) uses the same mechanism. The primitive only does exact-line
+ * matching — it knows nothing about comment syntax, which is why `Fence` is
+ * a parameter rather than hardcoded `#` markers.
+ */
+export interface UpsertFencedRegionResult {
+    text: string;
+    changed: boolean;
+}
+/**
+ * Idempotently inserts or replaces the body strictly between `fence.start`
+ * and `fence.end` in `text`, preserving everything outside byte-for-byte.
+ *
+ * - No markers found → appends the block (a blank line first, if the
+ *   existing text is non-empty and doesn't already end in one).
+ * - Exactly one start and one end, start before end → replaces the body
+ *   between them.
+ * - Anything else (unpaired, duplicated, out of order) → throws before
+ *   returning, so a caller writing atomically writes zero bytes.
+ *
+ * Returns `changed: false` (with byte-identical text) when nothing actually
+ * changes, so a caller can skip reopening the file entirely — no rewrite, no
+ * mtime churn.
+ */
+export declare function upsertFencedRegion(text: string, fence: Fence, body: readonly string[]): UpsertFencedRegionResult;
+/**
+ * Reads `filePath` (a missing file is treated as empty text), upserts the
+ * fenced region, and writes atomically — but only if the content actually
+ * changed, so a no-op re-run never touches the file's mtime. This is what
+ * makes re-init convergent: identical inputs produce zero writes.
+ */
+export declare function upsertFencedRegionInFile(filePath: string, fence: Fence, body: readonly string[]): Promise<{
+    changed: boolean;
+}>;
+/**
+ * Pure validation, comment-syntax-agnostic (matches the `contexture:<region>`
+ * token regardless of whether it's wrapped in `#`, `<!-- -->`, or anything
+ * else) — used by the pre-commit `fence_integrity` check to reject a staged
+ * file with an unpaired or duplicated marker, without needing to know or
+ * reconstruct the region's intended body content.
+ */
+export declare function validateFenceIntegrity(text: string): string[];
+//# sourceMappingURL=fenced-region.d.ts.map

package/dist/core/fs/fenced-region.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fenced-region.d.ts","sourceRoot":"","sources":["../../../src/core/fs/fenced-region.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAI3C;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,wBAAwB,CA6B1B;AAeD;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAsB/B;AAKD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA0B7D"}

package/dist/core/fs/fenced-region.js

@@ -0,0 +1,122 @@
+import { readFile } from 'node:fs/promises';
+import { MarkerMismatchError } from '../errors.js';
+import { writeFileAtomic } from './atomic.js';
+class FenceMismatch extends Error {
+}
+/**
+ * Idempotently inserts or replaces the body strictly between `fence.start`
+ * and `fence.end` in `text`, preserving everything outside byte-for-byte.
+ *
+ * - No markers found → appends the block (a blank line first, if the
+ *   existing text is non-empty and doesn't already end in one).
+ * - Exactly one start and one end, start before end → replaces the body
+ *   between them.
+ * - Anything else (unpaired, duplicated, out of order) → throws before
+ *   returning, so a caller writing atomically writes zero bytes.
+ *
+ * Returns `changed: false` (with byte-identical text) when nothing actually
+ * changes, so a caller can skip reopening the file entirely — no rewrite, no
+ * mtime churn.
+ */
+export function upsertFencedRegion(text, fence, body) {
+    const trailingNewline = text.endsWith('\n');
+    const lines = text.length === 0 ? [] : text.split('\n');
+    if (trailingNewline)
+        lines.pop(); // split on a trailing \n leaves a spurious trailing ''
+    const startIndices = indicesOf(lines, fence.start);
+    const endIndices = indicesOf(lines, fence.end);
+    if (startIndices.length === 0 && endIndices.length === 0) {
+        const out = [...lines];
+        if (out.length > 0 && out[out.length - 1] !== '')
+            out.push('');
+        out.push(fence.start, ...body, fence.end);
+        return finish(out, text);
+    }
+    if (startIndices.length === 1 &&
+        endIndices.length === 1 &&
+        startIndices[0] < endIndices[0]) {
+        const startIdx = startIndices[0];
+        const endIdx = endIndices[0];
+        const out = [...lines.slice(0, startIdx + 1), ...body, ...lines.slice(endIdx)];
+        return finish(out, text);
+    }
+    throw new FenceMismatch(`found ${startIndices.length} start marker(s) and ${endIndices.length} end marker(s)`);
+}
+function indicesOf(lines, needle) {
+    const result = [];
+    for (let i = 0; i < lines.length; i += 1) {
+        if (lines[i] === needle)
+            result.push(i);
+    }
+    return result;
+}
+function finish(lines, original) {
+    const text = lines.length === 0 ? '' : `${lines.join('\n')}\n`;
+    return { text, changed: text !== original };
+}
+/**
+ * Reads `filePath` (a missing file is treated as empty text), upserts the
+ * fenced region, and writes atomically — but only if the content actually
+ * changed, so a no-op re-run never touches the file's mtime. This is what
+ * makes re-init convergent: identical inputs produce zero writes.
+ */
+export async function upsertFencedRegionInFile(filePath, fence, body) {
+    let existing = '';
+    try {
+        existing = await readFile(filePath, 'utf8');
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT')
+            throw err;
+    }
+    let result;
+    try {
+        result = upsertFencedRegion(existing, fence, body);
+    }
+    catch (err) {
+        if (err instanceof FenceMismatch) {
+            throw new MarkerMismatchError(filePath, err.message);
+        }
+        throw err;
+    }
+    if (result.changed) {
+        await writeFileAtomic(filePath, result.text);
+    }
+    return { changed: result.changed };
+}
+const GENERIC_START_RE = />>>\s*contexture:(\S+)/;
+const GENERIC_END_RE = /<<<\s*contexture:(\S+)/;
+/**
+ * Pure validation, comment-syntax-agnostic (matches the `contexture:<region>`
+ * token regardless of whether it's wrapped in `#`, `<!-- -->`, or anything
+ * else) — used by the pre-commit `fence_integrity` check to reject a staged
+ * file with an unpaired or duplicated marker, without needing to know or
+ * reconstruct the region's intended body content.
+ */
+export function validateFenceIntegrity(text) {
+    const counts = new Map();
+    for (const line of text.split('\n')) {
+        const startMatch = GENERIC_START_RE.exec(line);
+        if (startMatch) {
+            const region = startMatch[1];
+            const entry = counts.get(region) ?? { start: 0, end: 0 };
+            entry.start += 1;
+            counts.set(region, entry);
+        }
+        const endMatch = GENERIC_END_RE.exec(line);
+        if (endMatch) {
+            const region = endMatch[1];
+            const entry = counts.get(region) ?? { start: 0, end: 0 };
+            entry.end += 1;
+            counts.set(region, entry);
+        }
+    }
+    const problems = [];
+    for (const [region, { start, end }] of counts) {
+        if (start !== 1 || end !== 1) {
+            problems.push(`region "${region}": found ${start} start marker(s) and ${end} end marker(s)`);
+        }
+    }
+    return problems;
+}
+//# sourceMappingURL=fenced-region.js.map

package/dist/core/fs/fenced-region.js.map

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

package/dist/core/git/exec.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The ONLY module in this codebase that spawns `git`. Every git operation —
+ * in Phase 0's `init`, and in every later phase's session/worktree/hook code
+ * — goes through this interface, always as an argv array, never a shell
+ * string (a store path or branch name containing a space or `;` must never
+ * reach a shell).
+ *
+ * Deliberately not a library (simple-git, isomorphic-git): a library either
+ * wraps errors in its own types we'd have to unwrap to produce our findings,
+ * or (isomorphic-git) can't do `git worktree` — which Phase 2's session model
+ * is built on — or `--follow` rename detection, which Phase 7's archive
+ * verifies. Raw `git` via execFile is the boring choice that survives both.
+ */
+export interface GitResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface GitRunOptions {
+    cwd: string;
+    /** When true, a non-zero exit resolves with the result instead of throwing. */
+    allowFailure?: boolean;
+}
+export interface GitRunner {
+    run(args: readonly string[], opts: GitRunOptions): Promise<GitResult>;
+}
+export declare function createExecFileGitRunner(): GitRunner;
+//# sourceMappingURL=exec.d.ts.map

package/dist/core/git/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../../src/core/git/exec.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,+EAA+E;IAC/E,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACvE;AAED,wBAAgB,uBAAuB,IAAI,SAAS,CAenD"}

package/dist/core/git/exec.js

@@ -0,0 +1,21 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+export function createExecFileGitRunner() {
+    return {
+        async run(args, opts) {
+            try {
+                const { stdout, stderr } = await execFileAsync('git', [...args], { cwd: opts.cwd });
+                return { stdout, stderr, exitCode: 0 };
+            }
+            catch (err) {
+                const e = err;
+                if (opts.allowFailure) {
+                    return { stdout: e.stdout ?? '', stderr: e.stderr ?? '', exitCode: e.code ?? 1 };
+                }
+                throw err;
+            }
+        },
+    };
+}
+//# sourceMappingURL=exec.js.map

package/dist/core/git/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../../src/core/git/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AA+B1C,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI;YAClB,IAAI,CAAC;gBACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;gBACpF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YACzC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,GAAG,GAA0D,CAAC;gBACrE,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;oBACtB,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;gBACnF,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}