ctxr-cli 0.1.0

package/dist/commands/graph-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-build.js","sourceRoot":"","sources":["../../src/commands/graph-build.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAyB,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAsB,MAAM,oBAAoB,CAAC;AAG7E,MAAM,CAAC,MAAM,QAAQ,GAAoB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAa/D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAY,EAAE,KAAK,GAAoB,EAAE;IACrE,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAE/B,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjF,MAAM,QAAQ,GAAc,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrD,IAAI,EAAE,qBAAqB;QAC3B,QAAQ,EAAE,SAAkB;QAC5B,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,MAAM,eAAe,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,4CAA4C,CAAC,CAAC,CAAC,WAAW,GAAG;QACjJ,OAAO,EAAE,CAAC,CAAC,IAAI;QACf,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KAChD,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE;QACzG,QAAQ;QACR,YAAY,EAAE,gBAAgB,KAAK,CAAC,KAAK,CAAC,MAAM,aAAa,KAAK,CAAC,KAAK,CAAC,MAAM,aAAa,KAAK,CAAC,QAAQ,CAAC,MAAM,oBAAoB;QACrI,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,cAAc;KAC3C,CAAC;AACJ,CAAC"}

package/dist/commands/graph-query.d.ts

@@ -0,0 +1,41 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import type { Direction, HubEntry } from '../core/graph/query.js';
+import type { GraphBuildResult } from '../core/graph/model.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export interface NeighborsFlags {
+    node: string;
+    depth?: number;
+    direction?: Direction;
+    as?: string;
+}
+export declare function executeNeighbors(store: Store, flags: NeighborsFlags): Promise<CommandOutcome<{
+    neighbors: string[];
+}>>;
+export interface PathFlags {
+    from: string;
+    to: string;
+    as?: string;
+}
+export declare function executePath(store: Store, flags: PathFlags): Promise<CommandOutcome<{
+    path: string[] | null;
+}>>;
+export interface SubgraphFlags {
+    ids: string[];
+    as?: string;
+}
+export declare function executeSubgraph(store: Store, flags: SubgraphFlags): Promise<CommandOutcome<GraphBuildResult>>;
+export interface HubsFlags {
+    top?: number;
+    as?: string;
+}
+export declare function executeHubs(store: Store, flags?: HubsFlags): Promise<CommandOutcome<{
+    hubs: HubEntry[];
+}>>;
+export interface OrphansFlags {
+    as?: string;
+}
+export declare function executeOrphans(store: Store, flags?: OrphansFlags): Promise<CommandOutcome<{
+    orphans: string[];
+}>>;
+//# sourceMappingURL=graph-query.d.ts.map

package/dist/commands/graph-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-query.d.ts","sourceRoot":"","sources":["../../src/commands/graph-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1E,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AA6B/D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,cAAc,CAAC;IAAE,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC,CAKlD;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,cAAc,CAAC;IAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;CAAE,CAAC,CAAC,CAUpD;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAKnH;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAE,SAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAC,CAAC,CAIpH;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAE,YAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC,CAI3H"}

package/dist/commands/graph-query.js

@@ -0,0 +1,63 @@
+import { GraphNodeNotFoundError, GraphNotBuiltError } from '../core/errors.js';
+import { ExitCode } from '../core/exit-codes.js';
+import { hubs, neighbors, orphans, shortestPath, subgraph } from '../core/graph/query.js';
+import { readGraph } from '../core/graph/persist.js';
+import { filterGraphByAudience } from '../core/graph/visibility-filter.js';
+export const requires = { store: 'required' };
+/**
+ * context-visibility spec: when `--as <context>` is given, the graph is
+ * filtered to only nodes visible to that context BEFORE any traversal runs
+ * — see filterGraphByAudience. Every subcommand below routes through this
+ * one loader so none of them can accidentally query the unfiltered graph.
+ */
+async function loadGraph(store, as) {
+    const graph = await readGraph(store);
+    if (!graph)
+        throw new GraphNotBuiltError();
+    return as ? filterGraphByAudience(store, graph, as) : graph;
+}
+function assertNode(graph, nodeId) {
+    if (!graph.nodes.some((n) => n.id === nodeId))
+        throw new GraphNodeNotFoundError(nodeId);
+}
+function outcome(store, data, humanSummary) {
+    return {
+        exitCode: ExitCode.Ok,
+        data,
+        findings: [],
+        humanSummary,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+export async function executeNeighbors(store, flags) {
+    const graph = await loadGraph(store, flags.as);
+    assertNode(graph, flags.node);
+    const result = neighbors(graph, flags.node, { depth: flags.depth, direction: flags.direction });
+    return outcome(store, { neighbors: result }, `${result.length} neighbor(s) of "${flags.node}".`);
+}
+export async function executePath(store, flags) {
+    const graph = await loadGraph(store, flags.as);
+    assertNode(graph, flags.from);
+    assertNode(graph, flags.to);
+    const result = shortestPath(graph, flags.from, flags.to);
+    return outcome(store, { path: result }, result ? `Path: ${result.join(' -> ')}` : `No path from "${flags.from}" to "${flags.to}".`);
+}
+export async function executeSubgraph(store, flags) {
+    const graph = await loadGraph(store, flags.as);
+    for (const id of flags.ids)
+        assertNode(graph, id);
+    const result = subgraph(graph, flags.ids);
+    return outcome(store, result, `Subgraph: ${result.nodes.length} node(s), ${result.edges.length} edge(s).`);
+}
+export async function executeHubs(store, flags = {}) {
+    const graph = await loadGraph(store, flags.as);
+    const result = hubs(graph, flags.top ?? 10);
+    return outcome(store, { hubs: result }, `Top ${result.length} hub(s) by backlink count.`);
+}
+export async function executeOrphans(store, flags = {}) {
+    const graph = await loadGraph(store, flags.as);
+    const result = orphans(graph);
+    return outcome(store, { orphans: result }, `${result.length} orphan node(s) (no links in or out).`);
+}
+//# sourceMappingURL=graph-query.js.map

package/dist/commands/graph-query.js.map

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

package/dist/commands/ingest.d.ts

@@ -0,0 +1,28 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import type { RunEnv } from '../core/env.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export interface IngestFlags {
+    path: string;
+    sourceType: string;
+    sourceId: string;
+}
+export interface IngestData {
+    path: string;
+    sourceType: string;
+    sourceId: string;
+    sourceHash: string;
+    ingested: string;
+}
+/**
+ * context-ingest spec: identity fields are assigned once, here, and never
+ * recomputed from the live body afterward — the hash computed in this
+ * function IS the frozen source-hash for this note's lifetime. Rebuilding
+ * the catalog before returning (rather than documenting it as a required
+ * next step) is this codebase's choice for task 6.6: a successful write
+ * leaves its own derived-artifact consequence consistent immediately,
+ * matching every other writer in the system (init's .gitignore/AGENTS.md
+ * reconciliation, catalog build itself).
+ */
+export declare function execute(env: RunEnv, store: Store, flags: IngestFlags): Promise<CommandOutcome<IngestData>>;
+//# sourceMappingURL=ingest.d.ts.map

package/dist/commands/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/commands/ingest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAO7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAOD;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAqChH"}

package/dist/commands/ingest.js

@@ -0,0 +1,60 @@
+import path from 'node:path';
+import { buildCatalog } from '../core/catalog/build.js';
+import { contentHashOfBody } from '../core/content/canonicalize.js';
+import { AlreadyIngestedError, NoteNotFoundError } from '../core/errors.js';
+import { ExitCode } from '../core/exit-codes.js';
+import { writeFileAtomic } from '../core/fs/atomic.js';
+import { hasSourceIdentity, INGESTED_FIELD, SOURCE_HASH_FIELD, SOURCE_ID_FIELD, SOURCE_TYPE_FIELD } from '../core/ingest/identity.js';
+import { parseNote } from '../core/notes/parse.js';
+import { renderNoteText } from '../core/notes/render.js';
+export const requires = { store: 'required' };
+function toStoreRelativePath(env, store, givenPath) {
+    const absolute = path.isAbsolute(givenPath) ? givenPath : path.resolve(env.cwd, givenPath);
+    return path.relative(store.root, absolute).split(path.sep).join('/');
+}
+/**
+ * context-ingest spec: identity fields are assigned once, here, and never
+ * recomputed from the live body afterward — the hash computed in this
+ * function IS the frozen source-hash for this note's lifetime. Rebuilding
+ * the catalog before returning (rather than documenting it as a required
+ * next step) is this codebase's choice for task 6.6: a successful write
+ * leaves its own derived-artifact consequence consistent immediately,
+ * matching every other writer in the system (init's .gitignore/AGENTS.md
+ * reconciliation, catalog build itself).
+ */
+export async function execute(env, store, flags) {
+    const relativePath = toStoreRelativePath(env, store, flags.path);
+    const absolutePath = path.join(store.root, relativePath);
+    let note;
+    try {
+        note = await parseNote(absolutePath, relativePath);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            throw new NoteNotFoundError(relativePath);
+        throw err;
+    }
+    if (hasSourceIdentity(note)) {
+        throw new AlreadyIngestedError(relativePath);
+    }
+    const sourceHash = contentHashOfBody(note.body);
+    const ingested = env.now().toISOString();
+    const frontmatter = {
+        ...note.frontmatter,
+        [SOURCE_TYPE_FIELD]: flags.sourceType,
+        [SOURCE_ID_FIELD]: flags.sourceId,
+        [SOURCE_HASH_FIELD]: sourceHash,
+        [INGESTED_FIELD]: ingested,
+    };
+    await writeFileAtomic(absolutePath, renderNoteText(frontmatter, note.body));
+    await buildCatalog(store);
+    return {
+        exitCode: ExitCode.Ok,
+        data: { path: relativePath, sourceType: flags.sourceType, sourceId: flags.sourceId, sourceHash, ingested },
+        findings: [],
+        humanSummary: `Ingested "${relativePath}" (source: ${flags.sourceType}/${flags.sourceId}).`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=ingest.js.map

package/dist/commands/ingest.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,28 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import { type TaxonomyLayerConfig } from '../config/schema.js';
+import { type RunEnv } from '../core/env.js';
+export declare const requires: CommandRequires;
+export interface InitFlags {
+    root?: string;
+    profile?: string;
+    taxonomy?: string;
+}
+export interface InitData {
+    root: string;
+    already_initialized: boolean;
+    created: string[];
+    unchanged: string[];
+    git: {
+        repository_created: boolean;
+        commit: string | null;
+        default_branch: string | null;
+    };
+    /** null when a custom taxonomy definition was supplied (no shipped profile applies). */
+    taxonomy: {
+        profile: string | null;
+        layers: TaxonomyLayerConfig[];
+    };
+    schema_version: number;
+}
+export declare function execute(env: RunEnv, flags: InitFlags): Promise<CommandOutcome<InitData>>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAsB1E,OAAO,EAAmE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAchI,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAgB5D,eAAO,MAAM,QAAQ,EAAE,eAAqC,CAAC;AAE7D,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB,EAAE,OAAO,CAAC;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE;QAAE,kBAAkB,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC3F,wFAAwF;IACxF,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,mBAAmB,EAAE,CAAA;KAAE,CAAC;IACpE,cAAc,EAAE,MAAM,CAAC;CACxB;AAwMD,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAY9F"}

package/dist/commands/init.js

@@ -0,0 +1,203 @@
+import { existsSync } from 'node:fs';
+import { mkdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { z } from 'zod';
+import { DEFAULT_ADAPTERS, DEFAULT_ARCHIVE_PATH, DEFAULT_CATALOG_PATH, DEFAULT_CATALOG_SECTION_MAX_BYTES, DEFAULT_CONVENTIONS_PATH, DEFAULT_DERIVED_PATHS, DEFAULT_DIFF_SIZE_CEILING_LINES, DEFAULT_EXCLUDE_PATHS, DEFAULT_HARD_WALLS, DEFAULT_IDENTITY_PATH, DEFAULT_INBOX_PATH, DEFAULT_INTERNAL_AUDIENCES, DEFAULT_PROCEDURES_PATH, DEFAULT_SESSION_BRANCH_PREFIX, DEFAULT_VISIBILITY_CONTEXT, DEFAULT_VISIBILITY_FIELD_KEY, DEFAULT_WORKTREES_PATH, } from '../config/defaults.js';
+import { configPathFor, readConfig } from '../config/load.js';
+import { renderStoreConfig } from '../config/render.js';
+import { SUPPORTED_SCHEMA_VERSION, TaxonomyLayerSchema } from '../config/schema.js';
+import { buildAgentsCanonicalSection, buildAgentsCaptureSection, buildAgentsConventionsSection, buildAgentsIdentitySection, buildAgentsLegRoutingSection, buildAgentsPlacementSection, agentsMdPath, } from '../core/agents-doc.js';
+import { ensureIdentityFiles } from '../core/identity.js';
+import { syncShippedSkills } from '../core/procedures.js';
+import { reconcileStore, WORKTREES_GITIGNORE_FENCE } from '../core/reconcile.js';
+import { isInteractive } from '../core/env.js';
+import { GitIdentityMissingError, InvalidTaxonomyFileError, TaxonomySelectionConflictError, UnknownTaxonomyProfileError, } from '../core/errors.js';
+import { ExitCode } from '../core/exit-codes.js';
+import { writeFileAtomic } from '../core/fs/atomic.js';
+import { upsertFencedRegionInFile } from '../core/fs/fenced-region.js';
+import { addPaths, commitIfStaged, currentBranch, findToplevel, gitInit, hasGitIdentity } from '../core/git/repo.js';
+import { configureHooksPath, installHooks } from '../core/hooks.js';
+import { DERIVED_GITIGNORE_FENCE } from '../core/markers.js';
+import { resolveRootForInit } from '../core/root.js';
+import { defaultProfile, DEFAULT_PROFILE_ID, profileById, SHIPPED_PROFILES } from '../taxonomy/profiles.js';
+export const requires = { store: 'absent' };
+const CustomTaxonomyFileSchema = z.object({ layers: z.array(TaxonomyLayerSchema) });
+async function resolveTaxonomy(env, flags) {
+    if (flags.profile && flags.taxonomy) {
+        throw new TaxonomySelectionConflictError();
+    }
+    if (flags.taxonomy) {
+        const text = await readFile(flags.taxonomy, 'utf8');
+        const raw = parseYaml(text);
+        const result = CustomTaxonomyFileSchema.safeParse(raw);
+        if (!result.success) {
+            const issues = result.error.issues.map((issue) => ({
+                path: issue.path.join('.') || '(root)',
+                message: issue.message,
+            }));
+            throw new InvalidTaxonomyFileError(flags.taxonomy, issues);
+        }
+        return { profileId: 'custom', layers: result.data.layers };
+    }
+    if (flags.profile) {
+        const profile = profileById(flags.profile);
+        if (!profile) {
+            throw new UnknownTaxonomyProfileError(flags.profile, SHIPPED_PROFILES.map((p) => p.id));
+        }
+        return { profileId: profile.id, layers: [...profile.layers] };
+    }
+    if (isInteractive(env)) {
+        const selectedId = await env.prompter.selectProfile({
+            message: 'Choose a taxonomy profile for this store:',
+            choices: SHIPPED_PROFILES.map((p) => ({ id: p.id, name: p.name, description: p.description })),
+            defaultId: DEFAULT_PROFILE_ID,
+        });
+        const profile = profileById(selectedId) ?? defaultProfile();
+        return { profileId: profile.id, layers: [...profile.layers] };
+    }
+    // Non-interactive, nothing specified: PARA immediately — never prompt, never block.
+    const profile = defaultProfile();
+    return { profileId: profile.id, layers: [...profile.layers] };
+}
+async function safeCurrentBranch(env, root) {
+    try {
+        return await currentBranch(env.git, root);
+    }
+    catch {
+        return null;
+    }
+}
+async function runInitCore(env, flags) {
+    const root = resolveRootForInit(env, flags);
+    await mkdir(root, { recursive: true });
+    const configPath = configPathFor(root);
+    // --- Idempotent path: already initialized -----------------------------
+    if (existsSync(configPath)) {
+        const config = await readConfig(root); // validates + gates schema_version
+        // Reconciling an existing store is exactly `ctxr update`'s job — one shared implementation.
+        await reconcileStore(env, root, config);
+        return {
+            data: {
+                root,
+                already_initialized: true,
+                created: [],
+                unchanged: [],
+                git: {
+                    repository_created: false,
+                    commit: null,
+                    default_branch: config.git.default_branch,
+                },
+                taxonomy: {
+                    profile: config.taxonomy.profile === 'custom' ? null : config.taxonomy.profile,
+                    layers: config.taxonomy.layers,
+                },
+                schema_version: config.schema_version,
+            },
+            findings: [],
+        };
+    }
+    // --- Resolve taxonomy in memory, no writes yet -------------------------
+    const taxonomy = await resolveTaxonomy(env, flags);
+    // --- Git preflight, still no writes -------------------------------------
+    const toplevel = await findToplevel(env.git, root);
+    const findings = [];
+    if (toplevel.kind === 'ancestor') {
+        findings.push({
+            code: 'git.ancestor_repository',
+            severity: 'warning',
+            message: `"${root}" is inside an existing git repository rooted at "${toplevel.toplevel}".`,
+            subject: toplevel.toplevel,
+        });
+    }
+    if (!(await hasGitIdentity(env.git, root, env.env))) {
+        throw new GitIdentityMissingError();
+    }
+    // --- Mutate: create the repo so we can learn its default branch name ----
+    const repositoryAlreadyExists = toplevel.kind === 'this-dir';
+    if (!repositoryAlreadyExists) {
+        await gitInit(env.git, root);
+    }
+    // Works even pre-commit: git init leaves HEAD pointing at an unborn branch.
+    const defaultBranch = (await safeCurrentBranch(env, root)) ?? 'main';
+    const config = {
+        schema_version: SUPPORTED_SCHEMA_VERSION,
+        taxonomy: { profile: taxonomy.profileId, layers: taxonomy.layers },
+        fields: { visibility: DEFAULT_VISIBILITY_FIELD_KEY },
+        visibility: { default_context: DEFAULT_VISIBILITY_CONTEXT, directory_defaults: {}, contexts: {} },
+        derived: { paths: [...DEFAULT_DERIVED_PATHS] },
+        retrieval: { exclude_paths: [...DEFAULT_EXCLUDE_PATHS] },
+        git: { default_branch: defaultBranch },
+        session: { branch_prefix: DEFAULT_SESSION_BRANCH_PREFIX, worktrees_path: DEFAULT_WORKTREES_PATH },
+        write_lifecycle: { diff_size_ceiling_lines: DEFAULT_DIFF_SIZE_CEILING_LINES },
+        catalog: { path: DEFAULT_CATALOG_PATH, section_max_bytes: DEFAULT_CATALOG_SECTION_MAX_BYTES },
+        disclosure: { internal_audiences: [...DEFAULT_INTERNAL_AUDIENCES], hard_walls: [...DEFAULT_HARD_WALLS] },
+        ingest: { inbox_path: DEFAULT_INBOX_PATH },
+        organize: { archive_path: DEFAULT_ARCHIVE_PATH },
+        identity: { path: DEFAULT_IDENTITY_PATH },
+        harness: { procedures_path: DEFAULT_PROCEDURES_PATH, conventions_path: DEFAULT_CONVENTIONS_PATH },
+        adapters: [...DEFAULT_ADAPTERS],
+    };
+    // Round-trips through the schema internally; throws before any byte is written if it doesn't.
+    const configText = renderStoreConfig(config);
+    await writeFileAtomic(configPath, configText);
+    const gitignorePath = path.join(root, '.gitignore');
+    await upsertFencedRegionInFile(gitignorePath, DERIVED_GITIGNORE_FENCE, config.derived.paths);
+    await upsertFencedRegionInFile(gitignorePath, WORKTREES_GITIGNORE_FENCE, [config.session.worktrees_path]);
+    await buildAgentsLegRoutingSection(root, config);
+    await buildAgentsCaptureSection(root, config);
+    await buildAgentsPlacementSection(root, config);
+    const identityFilesCreated = await ensureIdentityFiles(root, config);
+    const procedureFilesCreated = await syncShippedSkills(root, config);
+    await buildAgentsCanonicalSection(root, config);
+    await buildAgentsIdentitySection(root, config);
+    await buildAgentsConventionsSection(root, config);
+    // One directory per configured layer with a .gitkeep — makes Zettelkasten's
+    // zero-layer shape visibly different from PARA's at a glance. This is a
+    // deliberate addition beyond tasks.md's literal text (0.6), noted here
+    // rather than absorbed silently.
+    const layerGitkeeps = [];
+    for (const layer of config.taxonomy.layers) {
+        const dir = path.join(root, layer.path);
+        await mkdir(dir, { recursive: true });
+        const gitkeepPath = path.join(dir, '.gitkeep');
+        await writeFileAtomic(gitkeepPath, '');
+        layerGitkeeps.push(path.join(layer.path, '.gitkeep'));
+    }
+    // Version-controlled hooks (write-lifecycle spec): generated now, staged
+    // and committed below alongside the rest of the scaffold.
+    const { changed: hookFiles } = await installHooks(root, defaultBranch);
+    await configureHooksPath(env.git, root);
+    const relConfigPath = path.relative(root, configPath);
+    await addPaths(env.git, root, [relConfigPath, '.gitignore', path.relative(root, agentsMdPath(root)), ...layerGitkeeps, ...identityFilesCreated, ...procedureFilesCreated, ...hookFiles]);
+    const commitSha = await commitIfStaged(env.git, root, { kind: 'bootstrap' }, 'chore: initialize contexture store');
+    return {
+        data: {
+            root,
+            already_initialized: false,
+            created: [relConfigPath, '.gitignore', path.relative(root, agentsMdPath(root)), ...layerGitkeeps, ...identityFilesCreated, ...procedureFilesCreated, ...hookFiles],
+            unchanged: [],
+            git: { repository_created: !repositoryAlreadyExists, commit: commitSha, default_branch: defaultBranch },
+            taxonomy: {
+                profile: config.taxonomy.profile === 'custom' ? null : config.taxonomy.profile,
+                layers: config.taxonomy.layers,
+            },
+            schema_version: config.schema_version,
+        },
+        findings,
+    };
+}
+export async function execute(env, flags) {
+    const result = await runInitCore(env, flags);
+    return {
+        exitCode: ExitCode.Ok,
+        data: result.data,
+        findings: result.findings,
+        humanSummary: result.data.already_initialized
+            ? `"${result.data.root}" is already an initialized store.`
+            : `Initialized contexture store at "${result.data.root}".`,
+        storeRoot: result.data.root,
+        schemaVersion: result.data.schema_version,
+    };
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,iCAAiC,EACjC,wBAAwB,EACxB,qBAAqB,EACrB,+BAA+B,EAC/B,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,0BAA0B,EAC1B,uBAAuB,EACvB,6BAA6B,EAC7B,0BAA0B,EAC1B,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAA8C,MAAM,qBAAqB,CAAC;AAChI,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,6BAA6B,EAC7B,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,EAC3B,YAAY,GACb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEjF,OAAO,EAAE,aAAa,EAAe,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrH,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE5G,MAAM,CAAC,MAAM,QAAQ,GAAoB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAmB7D,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;AAQpF,KAAK,UAAU,eAAe,CAAC,GAAW,EAAE,KAAgB;IAC1D,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,8BAA8B,EAAE,CAAC;IAC7C,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAY,CAAC;QACvC,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACjD,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ;gBACtC,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC,CAAC;YACJ,MAAM,IAAI,wBAAwB,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IAC7D,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,2BAA2B,CACnC,KAAK,CAAC,OAAO,EACb,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAClC,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IAChE,CAAC;IAED,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC;YAClD,OAAO,EAAE,2CAA2C;YACpD,OAAO,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YAC9F,SAAS,EAAE,kBAAkB;SAC9B,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,WAAW,CAAC,UAAU,CAAC,IAAI,cAAc,EAAE,CAAC;QAC5D,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IAChE,CAAC;IAED,oFAAoF;IACpF,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;AAChE,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,GAAW,EAAE,IAAY;IACxD,IAAI,CAAC;QACH,OAAO,MAAM,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAOD,KAAK,UAAU,WAAW,CAAC,GAAW,EAAE,KAAgB;IACtD,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC5C,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAEvC,yEAAyE;IACzE,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,mCAAmC;QAC1E,4FAA4F;QAC5F,MAAM,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACxC,OAAO;YACL,IAAI,EAAE;gBACJ,IAAI;gBACJ,mBAAmB,EAAE,IAAI;gBACzB,OAAO,EAAE,EAAE;gBACX,SAAS,EAAE,EAAE;gBACb,GAAG,EAAE;oBACH,kBAAkB,EAAE,KAAK;oBACzB,MAAM,EAAE,IAAI;oBACZ,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,cAAc;iBAC1C;gBACD,QAAQ,EAAE;oBACR,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO;oBAC9E,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;iBAC/B;gBACD,cAAc,EAAE,MAAM,CAAC,cAAc;aACtC;YACD,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAEnD,2EAA2E;IAC3E,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,yBAAyB;YAC/B,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,IAAI,IAAI,qDAAqD,QAAQ,CAAC,QAAQ,IAAI;YAC3F,OAAO,EAAE,QAAQ,CAAC,QAAQ;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,CAAC,MAAM,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,uBAAuB,EAAE,CAAC;IACtC,CAAC;IAED,2EAA2E;IAC3E,MAAM,uBAAuB,GAAG,QAAQ,CAAC,IAAI,KAAK,UAAU,CAAC;IAC7D,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAC7B,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IACD,4EAA4E;IAC5E,MAAM,aAAa,GAAG,CAAC,MAAM,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,IAAI,MAAM,CAAC;IAErE,MAAM,MAAM,GAAgB;QAC1B,cAAc,EAAE,wBAAwB;QACxC,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE;QAClE,MAAM,EAAE,EAAE,UAAU,EAAE,4BAA4B,EAAE;QACpD,UAAU,EAAE,EAAE,eAAe,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACjG,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,qBAAqB,CAAC,EAAE;QAC9C,SAAS,EAAE,EAAE,aAAa,EAAE,CAAC,GAAG,qBAAqB,CAAC,EAAE;QACxD,GAAG,EAAE,EAAE,cAAc,EAAE,aAAa,EAAE;QACtC,OAAO,EAAE,EAAE,aAAa,EAAE,6BAA6B,EAAE,cAAc,EAAE,sBAAsB,EAAE;QACjG,eAAe,EAAE,EAAE,uBAAuB,EAAE,+BAA+B,EAAE;QAC7E,OAAO,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,iCAAiC,EAAE;QAC7F,UAAU,EAAE,EAAE,kBAAkB,EAAE,CAAC,GAAG,0BAA0B,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,kBAAkB,CAAC,EAAE;QACxG,MAAM,EAAE,EAAE,UAAU,EAAE,kBAAkB,EAAE;QAC1C,QAAQ,EAAE,EAAE,YAAY,EAAE,oBAAoB,EAAE;QAChD,QAAQ,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE;QACzC,OAAO,EAAE,EAAE,eAAe,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,wBAAwB,EAAE;QACjG,QAAQ,EAAE,CAAC,GAAG,gBAAgB,CAAC;KAChC,CAAC;IACF,8FAA8F;IAC9F,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE7C,MAAM,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACpD,MAAM,wBAAwB,CAAC,aAAa,EAAE,uBAAuB,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7F,MAAM,wBAAwB,CAAC,aAAa,EAAE,yBAAyB,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;IAC1G,MAAM,4BAA4B,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,2BAA2B,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,oBAAoB,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrE,MAAM,qBAAqB,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpE,MAAM,2BAA2B,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,0BAA0B,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,6BAA6B,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAElD,4EAA4E;IAC5E,wEAAwE;IACxE,uEAAuE;IACvE,iCAAiC;IACjC,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAC/C,MAAM,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACvC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,yEAAyE;IACzE,0DAA0D;IAC1D,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACvE,MAAM,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAExC,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACtD,MAAM,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,aAAa,EAAE,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,aAAa,EAAE,GAAG,oBAAoB,EAAE,GAAG,qBAAqB,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;IAEzL,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,oCAAoC,CAAC,CAAC;IAEnH,OAAO;QACL,IAAI,EAAE;YACJ,IAAI;YACJ,mBAAmB,EAAE,KAAK;YAC1B,OAAO,EAAE,CAAC,aAAa,EAAE,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,aAAa,EAAE,GAAG,oBAAoB,EAAE,GAAG,qBAAqB,EAAE,GAAG,SAAS,CAAC;YAClK,SAAS,EAAE,EAAE;YACb,GAAG,EAAE,EAAE,kBAAkB,EAAE,CAAC,uBAAuB,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE;YACvG,QAAQ,EAAE;gBACR,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO;gBAC9E,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;aAC/B;YACD,cAAc,EAAE,MAAM,CAAC,cAAc;SACtC;QACD,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,KAAgB;IACzD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7C,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,mBAAmB;YAC3C,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,oCAAoC;YAC1D,CAAC,CAAC,oCAAoC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI;QAC5D,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI;QAC3B,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,cAAc;KAC1C,CAAC;AACJ,CAAC"}

package/dist/commands/lint.d.ts

@@ -0,0 +1,30 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import type { CheckStatus } from '../core/checks/types.js';
+import type { RunEnv } from '../core/env.js';
+import type { Finding } from '../core/envelope.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export interface LintCheckSummary {
+    id: string;
+    title: string;
+    result: CheckStatus;
+    reason?: string;
+    findings?: Finding[];
+}
+export interface LintData {
+    checks: LintCheckSummary[];
+    summary: {
+        pass: number;
+        fail: number;
+        skip: number;
+    };
+}
+/**
+ * context-organize spec: "lint SHALL always exit 0 ... regardless of how
+ * many findings it reports" and "SHALL NOT be used as a gate." Runs the
+ * SAME check registry doctor does, filtered to `severity: 'observation'`
+ * instead of `'invariant'` — the type-level split (task 9.4) that keeps
+ * this command from ever affecting an exit code.
+ */
+export declare function execute(env: RunEnv, store: Store): Promise<CommandOutcome<LintData>>;
+//# sourceMappingURL=lint.d.ts.map

package/dist/commands/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/commands/lint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1E,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACvD;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAmC1F"}

package/dist/commands/lint.js

@@ -0,0 +1,48 @@
+import { CHECKS } from '../core/checks/manifest.js';
+import { runChecks } from '../core/checks/registry.js';
+import { ExitCode } from '../core/exit-codes.js';
+import { readGraph } from '../core/graph/persist.js';
+import { listNotes } from '../core/notes/list.js';
+export const requires = { store: 'required' };
+/**
+ * context-organize spec: "lint SHALL always exit 0 ... regardless of how
+ * many findings it reports" and "SHALL NOT be used as a gate." Runs the
+ * SAME check registry doctor does, filtered to `severity: 'observation'`
+ * instead of `'invariant'` — the type-level split (task 9.4) that keeps
+ * this command from ever affecting an exit code.
+ */
+export async function execute(env, store) {
+    const ctx = {
+        storeRoot: store.root,
+        config: store.config,
+        scope: 'store',
+        git: env.git,
+        notes: () => listNotes(store.root, store.config),
+        graph: () => readGraph(store),
+        catalog: async () => undefined,
+    };
+    const reports = await runChecks(CHECKS, ctx, { scope: 'store', severity: 'observation' });
+    const summary = {
+        pass: reports.filter((r) => r.result.status === 'pass').length,
+        fail: reports.filter((r) => r.result.status === 'fail').length,
+        skip: reports.filter((r) => r.result.status === 'skip').length,
+    };
+    return {
+        exitCode: ExitCode.Ok,
+        data: {
+            checks: reports.map((r) => ({
+                id: r.id,
+                title: r.title,
+                result: r.result.status,
+                reason: r.result.skipReason,
+                findings: r.result.findings.length > 0 ? r.result.findings : undefined,
+            })),
+            summary,
+        },
+        findings: reports.flatMap((r) => r.result.findings),
+        humanSummary: `lint: ${summary.pass} clean, ${summary.fail} with findings, ${summary.skip} skipped`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=lint.js.map

package/dist/commands/lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../src/commands/lint.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAIvD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGlD,MAAM,CAAC,MAAM,QAAQ,GAAoB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAe/D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,KAAY;IACrD,MAAM,GAAG,GAAiB;QACxB,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,OAAO;QACd,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;QAChD,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC;QAC7B,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;KAC/B,CAAC;IAEF,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC,CAAC;IAC1F,MAAM,OAAO,GAAG;QACd,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM;QAC9D,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM;QAC9D,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM;KAC/D,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,IAAI,EAAE;YACJ,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC1B,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM;gBACvB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,UAAU;gBAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;aACvE,CAAC,CAAC;YACH,OAAO;SACR;QACD,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;QACnD,YAAY,EAAE,SAAS,OAAO,CAAC,IAAI,WAAW,OAAO,CAAC,IAAI,mBAAmB,OAAO,CAAC,IAAI,UAAU;QACnG,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,cAAc;KAC3C,CAAC;AACJ,CAAC"}

package/dist/commands/migrate.d.ts

@@ -0,0 +1,30 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import type { MigrationDelta } from '../core/migrations/types.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export interface MigrateFlags {
+    dryRun?: boolean;
+}
+export interface MigrateMigrationResult {
+    id: string;
+    fromVersion: number;
+    toVersion: number;
+    deltas: MigrationDelta[];
+}
+export interface MigrateData {
+    currentVersion: number;
+    targetVersion: number;
+    applied: boolean;
+    migrations: MigrateMigrationResult[];
+}
+/**
+ * store-lifecycle spec: `--dry-run` reports exact deltas with nothing
+ * applied; a real run applies each pending migration in order, reloading
+ * the store's config after each one so a later migration in the chain
+ * (none exist yet, but the mechanism supports it) sees the version it
+ * actually needs to start from. Resumability is a property of each
+ * migration's own plan()/apply() (see core/migrations/types.ts) — this
+ * command does no extra bookkeeping of its own.
+ */
+export declare function execute(store: Store, flags: MigrateFlags): Promise<CommandOutcome<MigrateData>>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/commands/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/commands/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,sBAAsB,EAAE,CAAC;CACtC;AAED;;;;;;;;GAQG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CA4CrG"}