@software-dlc/cli 0.157.2

package/dist/local/config.d.ts

@@ -0,0 +1,22 @@
+export type SdlcRepositoryConfig = {
+    schema_version: 1;
+    repository_id: string;
+};
+export declare function getRepositoryConfigPath(repository_root: string, sidecar_dir?: string): string;
+export declare function parseRepositoryConfig(value: string): SdlcRepositoryConfig;
+export declare function readRepositoryConfig(repository_root: string, sidecar_dir?: string): Promise<SdlcRepositoryConfig>;
+export declare function writeRepositoryConfig(input: {
+    repository_root: string;
+    repository_id: string;
+    sidecar_dir?: string;
+}): Promise<string>;
+export declare function rebindRepositoryConfig(input: {
+    repository_root: string;
+    expected_repository_id: string;
+    repository_id: string;
+    sidecar_dir?: string;
+}): Promise<{
+    config_path: string;
+    changed: boolean;
+}>;
+//# sourceMappingURL=config.d.ts.map

package/dist/local/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/local/config.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,oBAAoB,GAAG;IACjC,cAAc,EAAE,CAAC,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,MAAM,EACvB,WAAW,SAAiC,GAC3C,MAAM,CAER;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAkBzE;AAED,wBAAsB,oBAAoB,CACxC,eAAe,EAAE,MAAM,EACvB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,oBAAoB,CAAC,CAO/B;AAED,wBAAsB,qBAAqB,CAAC,KAAK,EAAE;IACjD,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,MAAM,CAAC,CAclB;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE;IAClD,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAkCrD"}

package/dist/local/config.js

@@ -0,0 +1,57 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+export function getRepositoryConfigPath(repository_root, sidecar_dir = join(repository_root, '.sdlc')) {
+    return join(sidecar_dir, 'config.json');
+}
+export function parseRepositoryConfig(value) {
+    const parsed = JSON.parse(value);
+    if (typeof parsed !== 'object' ||
+        parsed === null ||
+        Array.isArray(parsed) ||
+        Object.keys(parsed).some((key) => key !== 'schema_version' && key !== 'repository_id') ||
+        !('schema_version' in parsed) ||
+        parsed.schema_version !== 1 ||
+        !('repository_id' in parsed) ||
+        typeof parsed.repository_id !== 'string' ||
+        !UUID_PATTERN.test(parsed.repository_id)) {
+        throw new Error('Invalid .sdlc/config.json repository association.');
+    }
+    return { schema_version: 1, repository_id: parsed.repository_id };
+}
+export async function readRepositoryConfig(repository_root, sidecar_dir) {
+    return parseRepositoryConfig(await readFile(getRepositoryConfigPath(repository_root, sidecar_dir), 'utf8'));
+}
+export async function writeRepositoryConfig(input) {
+    const config = parseRepositoryConfig(JSON.stringify({ schema_version: 1, repository_id: input.repository_id }));
+    const config_path = getRepositoryConfigPath(input.repository_root, input.sidecar_dir);
+    await mkdir(dirname(config_path), { recursive: true });
+    await writeFile(config_path, `${JSON.stringify(config, null, 2)}\n`, {
+        encoding: 'utf8',
+        flag: 'wx'
+    });
+    return config_path;
+}
+export async function rebindRepositoryConfig(input) {
+    const next_config = parseRepositoryConfig(JSON.stringify({ schema_version: 1, repository_id: input.repository_id }));
+    const current_config = await readRepositoryConfig(input.repository_root, input.sidecar_dir);
+    const config_path = getRepositoryConfigPath(input.repository_root, input.sidecar_dir);
+    if (current_config.repository_id === next_config.repository_id) {
+        return { config_path, changed: false };
+    }
+    if (current_config.repository_id !== input.expected_repository_id) {
+        throw new Error(`SDLC project association changed: expected ${input.expected_repository_id}, found ${current_config.repository_id}.`);
+    }
+    const temporary_path = `${config_path}.tmp-${randomUUID()}`;
+    try {
+        await writeFile(temporary_path, `${JSON.stringify(next_config, null, 2)}\n`, { encoding: 'utf8', flag: 'wx' });
+        await rename(temporary_path, config_path);
+    }
+    catch (error) {
+        await rm(temporary_path, { force: true });
+        throw error;
+    }
+    return { config_path, changed: true };
+}
+//# sourceMappingURL=config.js.map

package/dist/local/config.js.map

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

package/dist/local/document-commands.d.ts

@@ -0,0 +1,163 @@
+import type { DocumentBlock, DocumentComposition } from '@software-dlc/graph/types';
+import { z } from 'zod';
+export declare const document_outline_schema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    source_hash: z.ZodOptional<z.ZodString>;
+    entries: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        id: z.ZodString;
+        heading: z.ZodString;
+        level: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        prose: z.ZodString;
+        keep: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        embed: z.ZodObject<{
+            kind: z.ZodEnum<{
+                node: "node";
+                path: "path";
+                edge: "edge";
+            }>;
+            id: z.ZodString;
+            caption: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>]>>;
+}, z.core.$strict>;
+export type LocalDocumentOutline = z.infer<typeof document_outline_schema>;
+/**
+ * Prose Markdown as top-level blocks. The first block takes `id_prefix`, the
+ * next `id_prefix.2`, and so on; list items and their paragraphs extend their
+ * list's id, so an unchanged run of prose rebuilds with the same ids.
+ */
+export declare function proseToDocumentBlocks(markdown: string, id_prefix: string): DocumentBlock[];
+/**
+ * The composition an outline describes. Given the Document it replaces, a
+ * heading whose text is unchanged keeps its content (marks included) even if
+ * its level changes, and a prose run whose Markdown is unchanged keeps its
+ * blocks verbatim. Rewriting a run that holds formatting prose cannot carry is
+ * refused rather than silently flattening it.
+ */
+export declare function buildDocumentComposition(outline: LocalDocumentOutline, previous?: DocumentComposition): DocumentComposition;
+type DocumentState = {
+    label: string;
+    description?: string;
+    composition: DocumentComposition;
+};
+/** The hash an outline records of the Document it came from. */
+export declare function documentStateHash(state: DocumentState): string;
+/**
+ * An outline that rebuilds this Document: headings and graph embeds become
+ * their own entries, and every run of other top-level blocks becomes prose
+ * that keeps those blocks while its Markdown is unchanged.
+ */
+export declare function documentOutlineFromState(state: DocumentState): LocalDocumentOutline;
+export declare function createDocumentNode(input: {
+    projection_dir: string;
+    outline: LocalDocumentOutline;
+    node_id?: string;
+}): Promise<{
+    version: number;
+    status: string;
+    node_id: string;
+    blocks: number;
+}>;
+export declare function updateDocumentNode(input: {
+    projection_dir: string;
+    node_id: string;
+    outline: LocalDocumentOutline;
+}): Promise<{
+    version: number;
+    status: string;
+    node_id: string;
+    blocks: number;
+}>;
+export declare function documentOutlineForNode(projection_dir: string, node_id: string): Promise<{
+    schema_version: 1;
+    label: string;
+    entries: ({
+        id: string;
+        heading: string;
+        level?: number | undefined;
+    } | {
+        id: string;
+        prose: string;
+        keep?: string[] | undefined;
+    } | {
+        id: string;
+        embed: {
+            kind: "node" | "path" | "edge";
+            id: string;
+            caption?: string | undefined;
+        };
+    })[];
+    description?: string | undefined;
+    source_hash?: string | undefined;
+}>;
+export declare function exportDocumentNode(projection_dir: string, node_id: string): Promise<{
+    markdown: string;
+    lossy: string[];
+    version: number;
+    node_id: string;
+    label: string;
+}>;
+export declare function readDocumentNodeBounded(projection_dir: string, node_id: string, request: unknown): Promise<{
+    read: "outline";
+    entries: Array<{
+        id: string;
+        level: number;
+        text: string;
+    }>;
+    truncated: boolean;
+    version: number;
+    node_id: string;
+} | {
+    read: "section";
+    found: true;
+    heading_id: string;
+    heading: string;
+    markdown: string;
+    block_ids: string[];
+    truncated: boolean;
+    version: number;
+    node_id: string;
+} | {
+    read: "section";
+    found: false;
+    heading_id: string;
+    version: number;
+    node_id: string;
+} | {
+    read: "search";
+    query: string;
+    matches: Array<{
+        block_id: string;
+        section_heading_id?: string;
+        snippet: string;
+    }>;
+    truncated: boolean;
+    version: number;
+    node_id: string;
+}>;
+export declare function linkDocumentNode(input: {
+    projection_dir: string;
+    node_id: string;
+    target_id: string;
+    edge_id?: string;
+    description?: string;
+}): Promise<{
+    version: number;
+    status: string;
+    edge_id: string;
+    target_type?: undefined;
+} | {
+    version: number;
+    status: string;
+    edge_id: string;
+    target_type: string;
+}>;
+export declare function loadDocumentOutline(file_path: string): Promise<LocalDocumentOutline>;
+export {};
+//# sourceMappingURL=document-commands.d.ts.map

package/dist/local/document-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-commands.d.ts","sourceRoot":"","sources":["../../src/local/document-commands.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EAGpB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgDxB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;kBAezB,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AA4G3E;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,aAAa,EAAE,CAmGjB;AAqCD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,mBAAmB,CA2FrB;AAED,KAAK,aAAa,GAAG;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,mBAAmB,CAAC;CAClC,CAAC;AAEF,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAW9D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,aAAa,GACnB,oBAAoB,CA8CtB;AA+ED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;;;;;GAsBA;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,oBAAoB,CAAC;CAC/B;;;;;GA+CA;AAED,wBAAsB,sBAAsB,CAC1C,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;GAKhB;AAED,wBAAsB,kBAAkB,CACtC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM;;;;;;GAShB;AAED,wBAAsB,uBAAuB,CAC3C,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BA7lBA,CAAC;;;;;;GAkmBlB;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;;;;;;;;;;GA0DA;AAED,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,CAAC,CAI/B"}