ai-spector 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI Spector contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,150 @@
+# AI Spector
+
+Turn project notes and specs into structured documentation (SRS, basic design, detail design) inside [Cursor](https://cursor.com).
+
+You work with **slash commands**. The AI runs the `ai-spector` CLI behind the scenes. You only use the terminal once: **`npx ai-spector init`**.
+
+---
+
+## How you work (Cursor-first)
+
+### Once per project
+
+```bash
+npm install ai-spector
+npx ai-spector init
+```
+
+Put your source files in `docs/data-source/`, open the folder in Cursor, and turn on the **ai-spector** skill.
+
+### Then use slash commands
+
+| You run | What happens |
+|---------|----------------|
+| **`/analyze`** | Builds the graph skeleton, extracts knowledge (Graphify), merges use cases & features into the graph, validates |
+| **`/visualize-graph`** | Opens a browser report to inspect the graph and `knowledge.json` |
+| **`/validate-graph`** | Checks the graph before generation |
+| **`/generate-srs`** | Writes SRS files using graph context (not whole-folder guessing) |
+| **`/generate-basic-design`** | Basic design from the graph |
+| **`/generate-detail-design`** | Detail design from the graph |
+| **`/graph-impact <id>`** | Shows what to regenerate after you change something |
+
+**Typical path:**
+
+```text
+npx ai-spector init
+→ add docs/data-source/
+→ /analyze
+→ /validate-graph
+→ /generate-srs
+```
+
+Command details live in `.cursor/commands/` after `init` (start with `_workflow.md`).
+
+If a CLI step fails during a slash command, the agent should **stop**, show you the error, and help you fix it — not bypass the tool with manual edits. See `_cli-failures.md` in your project after `init`.
+
+---
+
+## What is the graph?
+
+All structure and traceability live in one file:
+
+`.ai-spector/graph/traceability.graph.json`
+
+- Chapters and headings → **sections** in the graph  
+- Use cases, features, actors → **domain nodes** with links (`listedIn`, `satisfies`, …)  
+- Files under `docs/srs/` → **output** of the graph, not the source of truth  
+
+**Graphify** (optional MCP) only helps read `docs/data-source/` during **`/analyze`**. The graph remains canonical.
+
+---
+
+## Requirements
+
+- Node.js 20+
+- [Cursor](https://cursor.com)
+- Graphify MCP for **`/analyze`**
+
+---
+
+## Try the example in this repo
+
+For package developers:
+
+```bash
+git clone <repo-url>
+cd ai-spector
+npm install && npm run build
+npm run init:example
+```
+
+Open **`example/`** as the Cursor workspace, add files under `example/docs/data-source/`, then run **`/analyze`** → **`/generate-srs`**.
+
+See [example/README.md](example/README.md).
+
+---
+
+## Project layout (after init)
+
+```text
+your-project/
+  .cursor/commands/          # /analyze, /generate-srs, …
+  .cursor/skills/ai-spector/
+  .ai-spector/
+    graph/traceability.graph.json
+    .docflow/analysis/knowledge.json
+    views/graph-knowledge.html   # after /visualize-graph
+  docs/
+    data-source/                 # your inputs
+    srs/                         # generated
+```
+
+---
+
+## For developers & contributors
+
+The CLI is the engine; Cursor commands wrap it.
+
+| Doc | Topic |
+|-----|--------|
+| [workflow-overview.md](docs/design/workflow-overview.md) | Graph-centric design |
+| [traceability-graph-redesign.md](docs/design/traceability-graph-redesign.md) | Schema and roadmap |
+
+**Build from source:**
+
+```bash
+npm install && npm run build
+npm run init:example
+```
+
+**CLI reference** (normally invoked by agents, not end users):
+
+| Command | Purpose |
+|---------|---------|
+| `ai-spector init` | Scaffold project |
+| `ai-spector analyze` | Section tree in graph |
+| `ai-spector graph merge --from-knowledge` | Domain nodes from staging |
+| `ai-spector graph validate` | Rules check |
+| `ai-spector graph visualize [--open]` | HTML report |
+| `ai-spector graph query <id> --json` | Context for generation |
+| `ai-spector graph impact <id> --json` | Regen scope |
+
+Option: `-r <path>` to point at another project root.
+
+---
+
+## Publish to npm (maintainers)
+
+```bash
+npm run prepublish:check   # build + list tarball contents
+npm login
+npm publish
+```
+
+Replace `YOUR_ORG/ai-spector` in `package.json` (`repository`, `homepage`, `bugs`) before publishing. See [PUBLISHING.md](PUBLISHING.md).
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,173 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { resolve } from "node:path";
+import { writeJson, readJson } from "./util/fs.js";
+import { resolveProjectPaths } from "./util/paths.js";
+import { buildSectionRegistry } from "./registry/build.js";
+import { bootstrapFromRegistry } from "./commands/bootstrap.js";
+import { validateGraph, formatIssues } from "./commands/validate.js";
+import { runInit } from "./commands/init.js";
+import { runAnalyzePrep } from "./commands/analyze.js";
+import { runGraphQuery } from "./commands/graph-query.js";
+import { runGraphImpact } from "./commands/graph-impact.js";
+import { runGraphMerge } from "./commands/graph-merge.js";
+import { runGraphVisualize } from "./commands/graph-visualize.js";
+const program = new Command();
+program
+    .name("ai-spector")
+    .description("AI Spector — init project, analyze prep, traceability graph, templates, Cursor workflow")
+    .version("0.1.0")
+    .option("-r, --root <path>", "Project root (auto-detect via .ai-spector/docflow.config.json)");
+function projectRootOpt(cmd) {
+    return cmd.optsWithGlobals().root;
+}
+async function getPaths(cmd) {
+    return resolveProjectPaths(projectRootOpt(cmd));
+}
+program
+    .command("init")
+    .description("Scaffold .ai-spector, Cursor commands/skills, and docs layout")
+    .option("-f, --force", "Overwrite existing scaffold files")
+    .option("-C, --cwd <path>", "Target directory", process.cwd())
+    .action(async (opts) => {
+    await runInit({
+        targetDir: resolve(opts.cwd ?? process.cwd()),
+        force: opts.force,
+    });
+});
+program
+    .command("analyze")
+    .description("Prepare graph structure (registry + bootstrap). Normally invoked by /analyze, not the user.")
+    .option("--merge", "After prep, merge knowledge.json or extract/patch.json into the graph if present")
+    .action(async (opts, cmd) => {
+    await runAnalyzePrep(projectRootOpt(cmd), { merge: opts.merge });
+});
+const graph = program.command("graph").description("Traceability graph operations");
+graph
+    .command("registry")
+    .description("Build section-registry.json from bundled SRS templates")
+    .action(async (_opts, cmd) => {
+    const paths = await getPaths(cmd);
+    const registry = await buildSectionRegistry(paths.root);
+    await writeJson(paths.registry, registry);
+    const total = registry.documents.reduce((n, d) => n + d.sections.length, 0);
+    console.log(`Wrote ${paths.registry} (${registry.documents.length} documents, ${total} sections)`);
+});
+graph
+    .command("bootstrap")
+    .description("Create structure nodes/edges from section registry")
+    .option("-i, --registry <path>", "Registry path")
+    .option("-o, --output <path>", "Graph output path")
+    .action(async (opts, cmd) => {
+    const paths = await getPaths(cmd);
+    const registryPath = opts.registry ?? paths.registry;
+    const graphPath = opts.output ?? paths.graph;
+    const registry = await readJson(registryPath);
+    const graph = bootstrapFromRegistry(registry);
+    await writeJson(graphPath, graph.toTraceabilityGraph());
+    console.log(`Wrote ${graphPath} (${graph.nodesById.size} nodes, ${graph.toTraceabilityGraph().edges.length} edges)`);
+});
+graph
+    .command("query <id>")
+    .description("Find relevant subgraph and projection paths (for IDE / generate)")
+    .option("-d, --direction <dir>", "out | in | both", "both")
+    .option("--depth <n>", "Traversal depth", "2")
+    .option("-e, --edges <types>", "Comma-separated edge types (default: generate set)")
+    .option("--json", "JSON output for agents")
+    .action(async (id, opts, cmd) => {
+    const paths = await getPaths(cmd);
+    await runGraphQuery({
+        graphPath: paths.graph,
+        seedId: id,
+        direction: opts.direction,
+        depth: Number(opts.depth),
+        edges: opts.edges,
+        json: opts.json,
+    });
+});
+graph
+    .command("impact <id>")
+    .description("Impact analysis: regenerate / review / downstream buckets")
+    .option("--change <type>", "Change type", "content_change")
+    .option("-o, --output <path>", "Write impact report JSON")
+    .option("--json", "Print JSON")
+    .action(async (id, opts, cmd) => {
+    const paths = await getPaths(cmd);
+    await runGraphImpact({
+        graphPath: paths.graph,
+        rulesPath: paths.rulesImpact,
+        originId: id,
+        change: opts.change,
+        output: opts.output,
+        json: opts.json,
+    });
+});
+graph
+    .command("merge [file]")
+    .description("Merge domain patch or knowledge.json into traceability graph (upsert nodes/edges)")
+    .option("--from-knowledge", "Read .ai-spector/.docflow/analysis/knowledge.json")
+    .option("-g, --graph <path>", "Graph path")
+    .option("-o, --write-patch <path>", "Write normalized extract patch before merge")
+    .option("--no-validate", "Skip validate after merge")
+    .option("--dry-run", "Compute merge stats without saving")
+    .action(async (file, opts, cmd) => {
+    const paths = await getPaths(cmd);
+    await runGraphMerge({
+        root: paths.root,
+        inputPath: file,
+        fromKnowledge: opts.fromKnowledge,
+        graphPath: opts.graph ?? paths.graph,
+        writePatch: opts.writePatch,
+        validate: !opts.noValidate,
+        dryRun: opts.dryRun,
+    });
+});
+graph
+    .command("visualize")
+    .description("Generate HTML report to explore graph and knowledge in a browser")
+    .option("-o, --output <path>", "Output HTML path")
+    .option("-g, --graph <path>", "Graph JSON path")
+    .option("--knowledge <path>", "knowledge.json path")
+    .option("--no-knowledge", "Omit knowledge.json from report")
+    .option("--open", "Open the HTML file in the default browser")
+    .action(async (opts, cmd) => {
+    const paths = await getPaths(cmd);
+    await runGraphVisualize({
+        root: paths.root,
+        graphPath: opts.graph ?? paths.graph,
+        knowledgePath: opts.knowledge,
+        output: opts.output,
+        open: opts.open,
+        skipKnowledge: opts.noKnowledge,
+    });
+});
+graph
+    .command("validate")
+    .description("Validate graph against bundled schema and traceability rules")
+    .option("-g, --graph <path>", "Graph path")
+    .option("-s, --schema <path>", "Schema path")
+    .option("--registry <path>", "Registry for REGISTRY-COMPLETE")
+    .option("--rules <path>", "Rules manifest path")
+    .action(async (opts, cmd) => {
+    const paths = await getPaths(cmd);
+    const issues = await validateGraph({
+        graphPath: opts.graph ?? paths.graph,
+        schemaPath: opts.schema ?? paths.schema,
+        registryPath: opts.registry ?? paths.registry,
+        rulesPath: opts.rules ?? paths.rulesTraceability,
+    });
+    console.log(formatIssues(issues));
+    const errors = issues.filter((i) => i.severity === "error");
+    if (errors.length > 0) {
+        process.exitCode = 1;
+    }
+});
+program.parseAsync(process.argv).catch((err) => {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(msg);
+    console.error("");
+    console.error("Fix the issue above, then re-run the same command.");
+    console.error("In Cursor, re-run the slash command (/analyze, /validate-graph, …) — see .cursor/commands/_cli-failures.md");
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/analyze.d.ts

@@ -0,0 +1,9 @@
+export interface AnalyzePrepOptions {
+    merge?: boolean;
+}
+/**
+ * Prepare traceability graph structure (registry + bootstrap + validate).
+ * Semantic knowledge extraction runs in Cursor via /analyze + Graphify MCP.
+ */
+export declare function runAnalyzePrep(root?: string, opts?: AnalyzePrepOptions): Promise<void>;
+//# sourceMappingURL=analyze.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/commands/analyze.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAyDf"}

package/dist/commands/analyze.js

@@ -0,0 +1,62 @@
+import { join } from "node:path";
+import { buildSectionRegistry } from "../registry/build.js";
+import { bootstrapFromRegistry } from "./bootstrap.js";
+import { validateGraph, formatIssues } from "./validate.js";
+import { loadDocflowConfig } from "../config/load.js";
+import { resolveProjectPaths } from "../util/paths.js";
+import { pathExists, readJson, writeJson } from "../util/fs.js";
+import { runGraphMerge } from "./graph-merge.js";
+/**
+ * Prepare traceability graph structure (registry + bootstrap + validate).
+ * Semantic knowledge extraction runs in Cursor via /analyze + Graphify MCP.
+ */
+export async function runAnalyzePrep(root, opts = {}) {
+    const paths = await resolveProjectPaths(root);
+    const { root: projectRoot } = await loadDocflowConfig(root);
+    const registry = await buildSectionRegistry(projectRoot);
+    await writeJson(paths.registry, registry);
+    const graph = bootstrapFromRegistry(registry);
+    await writeJson(paths.graph, graph.toTraceabilityGraph());
+    const issues = await validateGraph({
+        graphPath: paths.graph,
+        schemaPath: paths.schema,
+        registryPath: paths.registry,
+        rulesPath: paths.rulesTraceability,
+    });
+    const errors = issues.filter((i) => i.severity === "error");
+    if (errors.length > 0) {
+        console.log(formatIssues(issues));
+        throw new Error("Graph validation failed after analyze prep");
+    }
+    const statePath = join(projectRoot, ".ai-spector/.docflow/state.json");
+    const state = await readJson(statePath).catch(() => ({
+        version: 1,
+        analysis: {},
+    }));
+    const analysis = state.analysis ?? {};
+    analysis.graphPreparedAt = new Date().toISOString();
+    state.analysis = analysis;
+    await writeJson(statePath, state);
+    const total = registry.documents.reduce((n, d) => n + d.sections.length, 0);
+    console.log(`Graph ready: ${registry.documents.length} documents, ${total} sections`);
+    console.log(`  registry → ${paths.registry}`);
+    console.log(`  graph    → ${paths.graph}`);
+    console.log("");
+    const knowledgePath = join(projectRoot, ".ai-spector/.docflow/analysis/knowledge.json");
+    const patchPath = join(projectRoot, ".ai-spector/.docflow/extract/patch.json");
+    if (opts.merge) {
+        if ((await pathExists(knowledgePath)) || (await pathExists(patchPath))) {
+            await runGraphMerge({ root: projectRoot });
+            console.log("");
+            console.log("Merged domain knowledge into graph.");
+        }
+        else {
+            console.log("");
+            console.log("Skip merge: no knowledge.json or extract/patch.json yet.");
+        }
+    }
+    console.log("");
+    console.log("Structure ready. In Cursor run:  /analyze");
+    console.log("(The /analyze agent runs merge, validate, and Graphify — not you.)");
+}
+//# sourceMappingURL=analyze.js.map

package/dist/commands/analyze.js.map

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

package/dist/commands/bootstrap.d.ts

@@ -0,0 +1,4 @@
+import type { SectionRegistry } from "../types.js";
+import { InMemoryGraph } from "../graph/InMemoryGraph.js";
+export declare function bootstrapFromRegistry(registry: SectionRegistry): InMemoryGraph;
+//# sourceMappingURL=bootstrap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/commands/bootstrap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AA4C1D,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,aAAa,CA4B9E"}

package/dist/commands/bootstrap.js

@@ -0,0 +1,58 @@
+import { InMemoryGraph } from "../graph/InMemoryGraph.js";
+import { emptyGraph } from "../graph/load.js";
+function documentNode(doc) {
+    return {
+        id: doc.documentId,
+        type: "document",
+        template: doc.template,
+        ...(doc.output ? { output: doc.output } : {}),
+        ...(doc.outputPattern ? { outputPattern: doc.outputPattern } : {}),
+        ...(doc.perDomain ? { perDomain: doc.perDomain } : {}),
+    };
+}
+function sectionNode(sec, documentId) {
+    return {
+        id: sec.id,
+        type: "section",
+        documentId,
+        heading: sec.heading,
+        level: sec.level,
+        order: sec.order,
+    };
+}
+function resolveParentId(sections, index) {
+    const current = sections[index];
+    if (current.level <= 2) {
+        return null;
+    }
+    for (let i = index - 1; i >= 0; i--) {
+        if (sections[i].level === current.level - 1) {
+            return sections[i].id;
+        }
+    }
+    return null;
+}
+export function bootstrapFromRegistry(registry) {
+    const graph = InMemoryGraph.from(emptyGraph());
+    for (const doc of registry.documents) {
+        graph.addNode(documentNode(doc));
+        for (let i = 0; i < doc.sections.length; i++) {
+            const sec = doc.sections[i];
+            graph.addNode(sectionNode(sec, doc.documentId));
+            const parentSectionId = resolveParentId(doc.sections, i);
+            const parentId = parentSectionId ?? doc.documentId;
+            const partOf = { type: "partOf", from: sec.id, to: parentId };
+            const contains = { type: "contains", from: parentId, to: sec.id };
+            graph.addEdge(partOf);
+            graph.addEdge(contains);
+            if (i > 0) {
+                const prev = doc.sections[i - 1];
+                if (prev.level === sec.level) {
+                    graph.addEdge({ type: "follows", from: prev.id, to: sec.id });
+                }
+            }
+        }
+    }
+    return graph;
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/commands/bootstrap.js.map

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

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

@@ -0,0 +1,10 @@
+export interface GraphImpactCliOptions {
+    graphPath: string;
+    rulesPath: string;
+    originId: string;
+    change: string;
+    output?: string;
+    json?: boolean;
+}
+export declare function runGraphImpact(opts: GraphImpactCliOptions): Promise<void>;
+//# sourceMappingURL=graph-impact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-impact.d.ts","sourceRoot":"","sources":["../../src/commands/graph-impact.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B/E"}

package/dist/commands/graph-impact.js

@@ -0,0 +1,31 @@
+import { mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+import { writeJson } from "../util/fs.js";
+import { loadInMemoryGraph } from "../graph/loadGraph.js";
+import { computeImpact, loadImpactRules } from "../graph/impact.js";
+export async function runGraphImpact(opts) {
+    const g = await loadInMemoryGraph(opts.graphPath);
+    const rules = await loadImpactRules(opts.rulesPath);
+    const result = computeImpact(g, opts.originId, opts.change, rules);
+    if (opts.output) {
+        await mkdir(dirname(opts.output), { recursive: true });
+        await writeJson(opts.output, result);
+    }
+    if (opts.json || opts.output) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log(`Impact from ${result.origin.id} (${result.origin.change})`);
+    for (const [bucket, entries] of Object.entries(result.affected)) {
+        console.log(`\n${bucket}:`);
+        if (entries.length === 0) {
+            console.log("  (none)");
+            continue;
+        }
+        for (const e of entries) {
+            const path = e.projectionPath ? ` → ${e.projectionPath}` : "";
+            console.log(`  - ${e.id} (${e.type})${path}`);
+        }
+    }
+}
+//# sourceMappingURL=graph-impact.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-impact.js","sourceRoot":"","sources":["../../src/commands/graph-impact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAWpE,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAA2B;IAC9D,MAAM,CAAC,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAEnE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IACzE,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChE,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC;QAC5B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACxB,SAAS;QACX,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,11 @@
+export interface GraphMergeOptions {
+    root?: string;
+    inputPath?: string;
+    fromKnowledge?: boolean;
+    graphPath?: string;
+    writePatch?: string;
+    validate?: boolean;
+    dryRun?: boolean;
+}
+export declare function runGraphMerge(opts: GraphMergeOptions): Promise<void>;
+//# sourceMappingURL=graph-merge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-merge.d.ts","sourceRoot":"","sources":["../../src/commands/graph-merge.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8E1E"}