@nazty_labs/common-ground 0.5.1

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const version: string;

package/dist/version.js

@@ -0,0 +1,2 @@
+import { readFileSync } from 'node:fs';
+export const version = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;

package/dist/workflow.d.ts

@@ -0,0 +1,450 @@
+import { type FactChange } from './review.js';
+import { z } from 'zod';
+import { Store } from './store.js';
+import { Fact, type RegistryRecord } from './model.js';
+export declare const Patch: z.ZodObject<{
+    taskId: z.ZodOptional<z.ZodString>;
+    chapterId: z.ZodString;
+    factIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    touchedPaths: z.ZodArray<z.ZodPipeline<z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodString, string, string>>, "many">;
+    tidyId: z.ZodOptional<z.ZodString>;
+    verification: z.ZodObject<{
+        sourceFiles: z.ZodArray<z.ZodPipeline<z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodString, string, string>>, "many">;
+        documentFiles: z.ZodArray<z.ZodPipeline<z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodString, string, string>>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        sourceFiles: string[];
+        documentFiles: string[];
+    }, {
+        sourceFiles: string[];
+        documentFiles: string[];
+    }>;
+    reviews: z.ZodArray<z.ZodObject<{
+        chapterId: z.ZodString;
+        expectedRevision: z.ZodNumber;
+        reviewedAllFacts: z.ZodLiteral<true>;
+    } & {
+        replacements: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            statement: z.ZodString;
+            evidence: z.ZodArray<z.ZodObject<{
+                path: z.ZodPipeline<z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodString, string, string>>;
+                quote: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                path: string;
+                quote: string;
+            }, {
+                path: string;
+                quote: string;
+            }>, "many">;
+        } & {
+            sourceScope: z.ZodArray<z.ZodPipeline<z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodString, string, string>>, "many">;
+            dependsOn: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            statement: string;
+            evidence: {
+                path: string;
+                quote: string;
+            }[];
+            sourceScope: string[];
+            dependsOn: string[];
+        }, {
+            id: string;
+            statement: string;
+            evidence: {
+                path: string;
+                quote: string;
+            }[];
+            sourceScope: string[];
+            dependsOn?: string[] | undefined;
+        }>, "many">>;
+        removeFactIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        reason: z.ZodString;
+        maintenance: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            factId: z.ZodString;
+            action: z.ZodEnum<["correct", "merge", "remove", "tighten"]>;
+            reason: z.ZodString;
+            replacement: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            factId: string;
+            action: "correct" | "merge" | "remove" | "tighten";
+            reason: string;
+            replacement?: string | undefined;
+        }, {
+            factId: string;
+            action: "correct" | "merge" | "remove" | "tighten";
+            reason: string;
+            replacement?: string | undefined;
+        }>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        reason: string;
+        chapterId: string;
+        expectedRevision: number;
+        reviewedAllFacts: true;
+        replacements: {
+            id: string;
+            statement: string;
+            evidence: {
+                path: string;
+                quote: string;
+            }[];
+            sourceScope: string[];
+            dependsOn: string[];
+        }[];
+        removeFactIds: string[];
+        maintenance?: {
+            factId: string;
+            action: "correct" | "merge" | "remove" | "tighten";
+            reason: string;
+            replacement?: string | undefined;
+        }[] | undefined;
+    }, {
+        reason: string;
+        chapterId: string;
+        expectedRevision: number;
+        reviewedAllFacts: true;
+        maintenance?: {
+            factId: string;
+            action: "correct" | "merge" | "remove" | "tighten";
+            reason: string;
+            replacement?: string | undefined;
+        }[] | undefined;
+        replacements?: {
+            id: string;
+            statement: string;
+            evidence: {
+                path: string;
+                quote: string;
+            }[];
+            sourceScope: string[];
+            dependsOn?: string[] | undefined;
+        }[] | undefined;
+        removeFactIds?: string[] | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    chapterId: string;
+    touchedPaths: string[];
+    reviews: {
+        reason: string;
+        chapterId: string;
+        expectedRevision: number;
+        reviewedAllFacts: true;
+        replacements: {
+            id: string;
+            statement: string;
+            evidence: {
+                path: string;
+                quote: string;
+            }[];
+            sourceScope: string[];
+            dependsOn: string[];
+        }[];
+        removeFactIds: string[];
+        maintenance?: {
+            factId: string;
+            action: "correct" | "merge" | "remove" | "tighten";
+            reason: string;
+            replacement?: string | undefined;
+        }[] | undefined;
+    }[];
+    verification: {
+        sourceFiles: string[];
+        documentFiles: string[];
+    };
+    factIds?: string[] | undefined;
+    tidyId?: string | undefined;
+    taskId?: string | undefined;
+}, {
+    chapterId: string;
+    touchedPaths: string[];
+    reviews: {
+        reason: string;
+        chapterId: string;
+        expectedRevision: number;
+        reviewedAllFacts: true;
+        maintenance?: {
+            factId: string;
+            action: "correct" | "merge" | "remove" | "tighten";
+            reason: string;
+            replacement?: string | undefined;
+        }[] | undefined;
+        replacements?: {
+            id: string;
+            statement: string;
+            evidence: {
+                path: string;
+                quote: string;
+            }[];
+            sourceScope: string[];
+            dependsOn?: string[] | undefined;
+        }[] | undefined;
+        removeFactIds?: string[] | undefined;
+    }[];
+    verification: {
+        sourceFiles: string[];
+        documentFiles: string[];
+    };
+    factIds?: string[] | undefined;
+    tidyId?: string | undefined;
+    taskId?: string | undefined;
+}>;
+export declare const Admission: z.ZodObject<{
+    reviews: z.ZodArray<z.ZodObject<{
+        chapterId: z.ZodString;
+        expectedRevision: z.ZodNumber;
+        reviewedAllFacts: z.ZodLiteral<true>;
+    }, "strict", z.ZodTypeAny, {
+        chapterId: string;
+        expectedRevision: number;
+        reviewedAllFacts: true;
+    }, {
+        chapterId: string;
+        expectedRevision: number;
+        reviewedAllFacts: true;
+    }>, "many">;
+    verification: z.ZodObject<{
+        sourceFiles: z.ZodArray<z.ZodPipeline<z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodString, string, string>>, "many">;
+        documentFiles: z.ZodArray<z.ZodPipeline<z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodString, string, string>>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        sourceFiles: string[];
+        documentFiles: string[];
+    }, {
+        sourceFiles: string[];
+        documentFiles: string[];
+    }>;
+}, "strict", z.ZodTypeAny, {
+    reviews: {
+        chapterId: string;
+        expectedRevision: number;
+        reviewedAllFacts: true;
+    }[];
+    verification: {
+        sourceFiles: string[];
+        documentFiles: string[];
+    };
+}, {
+    reviews: {
+        chapterId: string;
+        expectedRevision: number;
+        reviewedAllFacts: true;
+    }[];
+    verification: {
+        sourceFiles: string[];
+        documentFiles: string[];
+    };
+}>;
+type Draft = {
+    chapterId: string;
+    fact: z.infer<typeof Fact>;
+    fingerprint: string;
+};
+type Task = {
+    phase: 'active' | 'awaiting-approval';
+    paths: string[];
+    cache: Record<string, string>;
+    changes: Record<string, string>;
+    changeDetails?: Record<string, FactChange>;
+    pending: string[];
+    drafts: Draft[];
+};
+/** Ignored, task-scoped bookkeeping. No prompt history or model calls; only changed fact records and task metadata. */
+export declare class Workflow {
+    readonly store: Store;
+    constructor(store: Store);
+    name(id: string): string;
+    task(id: string): Promise<Task>;
+    save(id: string, task: Task): Promise<void>;
+    reuse(id: string | undefined, key: unknown, value: unknown, context: unknown, refresh?: boolean): Promise<unknown>;
+    start(paths?: string[], signal?: string): Promise<{
+        state: string;
+        next: string;
+        proposalPath?: undefined;
+    } | {
+        state: string;
+        proposalPath: string;
+        next: {
+            action: string;
+            approvalRequired: boolean;
+            command: string;
+            schema: string;
+            guide: string;
+            authorization: string;
+        };
+    } | {
+        routes: {
+            items: {
+                chapterId: string;
+                title: string;
+            }[];
+            total: number;
+            hasMore: boolean;
+        };
+        next: string;
+        setup?: {
+            state: string;
+            boundariesApproved: boolean;
+            emptyChapters: string[];
+            next: {
+                action: string;
+                approvalRequired: boolean;
+                schema: string;
+            };
+        } | undefined;
+        taskId: `${string}-${string}-${string}-${string}-${string}`;
+        state?: undefined;
+        proposalPath?: undefined;
+    }>;
+    assess(id: string, paths: string[], cursor?: string, limit?: number, refresh?: boolean): Promise<unknown>;
+    prepare(input: unknown): Promise<{
+        noop: true;
+        proposalId?: undefined;
+        changedChapters?: undefined;
+        reviewedChapters?: undefined;
+    } | {
+        noop: false;
+        proposalId: `${string}-${string}-${string}-${string}-${string}`;
+        changedChapters: string[];
+        reviewedChapters: string[];
+    }>;
+    draftFingerprint(registry: RegistryRecord, chapterId: string, fact: z.infer<typeof Fact>): Promise<string>;
+    propose(id: string, chapterId: string, values: unknown): Promise<{
+        queued: number;
+        total: number;
+        sharedKnowledgeChanged: boolean;
+    }>;
+    draftStates(task: Task, registry: RegistryRecord): Promise<{
+        kind: string;
+        factId: string;
+        statement: string;
+        evidencePaths: string[];
+        stale: boolean;
+        recommendation: string;
+    }[]>;
+    finish(id: string, cursor?: string, limit?: number): Promise<{
+        reviewPrompt?: string | undefined;
+        reviewFormat?: string | undefined;
+        items: ({
+            kind: string;
+            factId: string;
+            statement: string;
+            evidencePaths: string[];
+            stale: boolean;
+            recommendation: string;
+        } | {
+            kind: string;
+            proposalId: string;
+        } | {
+            reason: string;
+            changedSinceUpdate: boolean;
+            evidenceStatus: string;
+            recommendation: string;
+            approvalRequired: boolean;
+            evidenceDetails?: string | undefined;
+            change?: string | undefined;
+            fields?: {
+                [k: string]: {
+                    before: {} | null;
+                    after: {} | null;
+                };
+            } | undefined;
+            evidencePaths?: string[] | undefined;
+            statement?: string | undefined;
+            kind: string;
+            factId: string;
+        })[];
+        total: number;
+        nextCursor: string | null;
+        notification: string;
+    }>;
+    proposals(id: string, cursor?: string, limit?: number): Promise<{
+        items: {
+            chapterId: string;
+            fact: z.infer<typeof Fact>;
+        }[];
+        total: number;
+        nextCursor: string | null;
+    }>;
+    drop(id: string, keys: string[]): Promise<{
+        remaining: number;
+        sharedKnowledgeChanged: boolean;
+    }>;
+    admissionPlan(id: string): Promise<{
+        task: Task;
+        registry: {
+            schemaVersion: 2;
+            pillars: {
+                id: string;
+                title: string;
+                scope: string;
+                excludes: string;
+                chapters: {
+                    id: string;
+                    title: string;
+                    scope: string;
+                    excludes: string;
+                    paths: string[];
+                    revision: number;
+                    facts: {
+                        id: string;
+                        statement: string;
+                        evidence: {
+                            path: string;
+                            quote: string;
+                        }[];
+                        sourceScope: string[];
+                        dependsOn: string[];
+                    }[];
+                    sources: Record<string, string>;
+                    dependencyFingerprints: Record<string, string>;
+                }[];
+            }[];
+        };
+        candidate: {
+            schemaVersion: 2;
+            pillars: {
+                id: string;
+                title: string;
+                scope: string;
+                excludes: string;
+                chapters: {
+                    id: string;
+                    title: string;
+                    scope: string;
+                    excludes: string;
+                    paths: string[];
+                    revision: number;
+                    facts: {
+                        id: string;
+                        statement: string;
+                        evidence: {
+                            path: string;
+                            quote: string;
+                        }[];
+                        sourceScope: string[];
+                        dependsOn: string[];
+                    }[];
+                    sources: Record<string, string>;
+                    dependencyFingerprints: Record<string, string>;
+                }[];
+            }[];
+        };
+        keys: string[];
+    }>;
+    proposalReview(id: string, cursor?: string, limit?: number): Promise<{
+        items: ({
+            kind: string;
+            chapterId: string;
+            expectedRevision: number;
+        } | {
+            kind: string;
+            path: string;
+        })[];
+        total: number;
+        nextCursor: string | null;
+    }>;
+    accept(id: string, input: unknown): Promise<{
+        admitted: number;
+        changedChapters: string[];
+    }>;
+}
+export {};