cotx-engine 0.1.0

package/dist/commands/query.js

@@ -0,0 +1,47 @@
+import { CotxStore } from '../store/store.js';
+import { CotxGraph } from '../query/graph-index.js';
+export async function commandQuery(projectRoot, keyword, options) {
+    const store = new CotxStore(projectRoot);
+    if (!store.exists()) {
+        console.log('No .cotx/ found. Run: cotx compile');
+        return;
+    }
+    const graph = CotxGraph.fromStore(store);
+    const results = graph.search(keyword, options.layer);
+    if (results.length === 0) {
+        console.log(`No results for "${keyword}"`);
+        return;
+    }
+    console.log(`Found ${results.length} results for "${keyword}":\n`);
+    for (const node of results) {
+        const edges = graph.neighbors(node.id, 'both');
+        console.log(`[${node.layer}] ${node.id}`);
+        // Show key info based on layer
+        const data = node.data;
+        if (node.layer === 'module' && data.canonical_entry) {
+            console.log(`  entry: ${data.canonical_entry}`);
+            console.log(`  files: ${data.files?.length ?? 0}`);
+        }
+        else if (node.layer === 'concept') {
+            console.log(`  appears_in: ${data.appears_in?.length ?? 0} files`);
+            console.log(`  module: ${data.layer}`);
+        }
+        else if (node.layer === 'contract') {
+            console.log(`  ${data.consumer} → ${data.provider}`);
+            console.log(`  interface: ${data.interface?.join(', ')}`);
+        }
+        else if (node.layer === 'flow') {
+            console.log(`  trigger: ${data.trigger}`);
+            console.log(`  steps: ${data.steps?.length ?? 0}`);
+        }
+        else if (node.layer === 'concern') {
+            console.log(`  type: ${data.type}, severity: ${data.severity}`);
+        }
+        if (edges.length > 0) {
+            const rels = edges.slice(0, 5).map(e => e.from === node.id ? `→ ${e.to} (${e.relation})` : `← ${e.from} (${e.relation})`);
+            console.log(`  relations: ${rels.join(', ')}`);
+        }
+        console.log();
+    }
+}
+//# sourceMappingURL=query.js.map

package/dist/commands/query.js.map

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

package/dist/commands/rename.d.ts

@@ -0,0 +1,5 @@
+export declare function commandRename(projectRoot: string, layer: string, oldId: string, newId: string): Promise<{
+    success: boolean;
+    message: string;
+    updatedFiles: string[];
+}>;

package/dist/commands/rename.js

@@ -0,0 +1,163 @@
+import { CotxStore } from '../store/store.js';
+import { rebuildDerivedIndex } from '../store/derived-index.js';
+import { CotxGraph } from '../query/graph-index.js';
+import fs from 'node:fs';
+import path from 'node:path';
+import yaml from 'js-yaml';
+export async function commandRename(projectRoot, layer, oldId, newId) {
+    const store = new CotxStore(projectRoot);
+    if (!store.exists()) {
+        return { success: false, message: 'No .cotx/ found.', updatedFiles: [] };
+    }
+    const validLayers = ['module', 'concept', 'contract', 'flow'];
+    if (!validLayers.includes(layer)) {
+        return {
+            success: false,
+            message: `Invalid layer: ${layer}. Use: ${validLayers.join(', ')}`,
+            updatedFiles: [],
+        };
+    }
+    if (layer === 'module') {
+        return renameModule(store, projectRoot, oldId, newId);
+    }
+    else if (layer === 'concept') {
+        return renameSimple(store, projectRoot, 'concepts', oldId, newId, (data) => {
+            data.id = newId;
+            return data;
+        });
+    }
+    else if (layer === 'contract') {
+        return renameSimple(store, projectRoot, 'contracts', oldId, newId, (data) => {
+            data.id = newId;
+            return data;
+        });
+    }
+    else {
+        // flow
+        return renameSimple(store, projectRoot, 'flows', oldId, newId, (data) => {
+            data.id = newId;
+            return data;
+        });
+    }
+}
+function renameSimple(_store, projectRoot, dir, oldId, newId, transform) {
+    const oldPath = _store.nodeFilePath(dir, oldId);
+    const newPath = _store.nodeFilePath(dir, newId);
+    if (!fs.existsSync(oldPath)) {
+        return { success: false, message: `${dir}/${oldId} not found`, updatedFiles: [] };
+    }
+    if (fs.existsSync(newPath)) {
+        return { success: false, message: `${dir}/${newId} already exists`, updatedFiles: [] };
+    }
+    const data = yaml.load(fs.readFileSync(oldPath, 'utf-8'));
+    const transformed = transform(data);
+    fs.writeFileSync(newPath, yaml.dump(transformed, { lineWidth: 120 }), 'utf-8');
+    fs.unlinkSync(oldPath);
+    rebuildDerivedIndex(_store);
+    CotxGraph.invalidateCache();
+    return {
+        success: true,
+        message: `Renamed ${dir}/${oldId} → ${newId}`,
+        updatedFiles: [`${dir}/${newId}.yaml`],
+    };
+}
+function renameModule(store, projectRoot, oldId, newId) {
+    if (!store.listModules().includes(oldId)) {
+        return { success: false, message: `Module "${oldId}" not found`, updatedFiles: [] };
+    }
+    if (store.listModules().includes(newId)) {
+        return { success: false, message: `Module "${newId}" already exists`, updatedFiles: [] };
+    }
+    const updatedFiles = [];
+    const cotxDir = path.join(projectRoot, '.cotx');
+    // 1. Rename module file — update id, then delete old file
+    const mod = store.readModule(oldId);
+    mod.id = newId;
+    store.writeModule(mod);
+    fs.unlinkSync(store.nodeFilePath('modules', oldId));
+    updatedFiles.push(`modules/${newId}.yaml`);
+    // 2. Update other modules' depends_on / depended_by
+    for (const id of store.listModules()) {
+        if (id === newId)
+            continue;
+        const other = store.readModule(id);
+        let changed = false;
+        const depIdx = other.depends_on?.indexOf(oldId) ?? -1;
+        if (depIdx >= 0) {
+            other.depends_on[depIdx] = newId;
+            changed = true;
+        }
+        const revIdx = other.depended_by?.indexOf(oldId) ?? -1;
+        if (revIdx >= 0) {
+            other.depended_by[revIdx] = newId;
+            changed = true;
+        }
+        if (changed) {
+            store.writeModule(other);
+            updatedFiles.push(`modules/${id}.yaml`);
+        }
+    }
+    // 3. Update contracts referencing this module
+    for (const id of store.listContracts()) {
+        const contract = store.readContract(id);
+        let changed = false;
+        if (contract.provider === oldId) {
+            contract.provider = newId;
+            changed = true;
+        }
+        if (contract.consumer === oldId) {
+            contract.consumer = newId;
+            changed = true;
+        }
+        if (changed) {
+            // Also rename the contract file if its id embeds the old module name
+            const newContractId = contract.id.replace(oldId, newId);
+            if (newContractId !== contract.id) {
+                const oldContractPath = store.nodeFilePath('contracts', contract.id);
+                contract.id = newContractId;
+                store.writeContract(contract);
+                if (fs.existsSync(oldContractPath))
+                    fs.unlinkSync(oldContractPath);
+                updatedFiles.push(`contracts/${newContractId}.yaml`);
+            }
+            else {
+                store.writeContract(contract);
+                updatedFiles.push(`contracts/${contract.id}.yaml`);
+            }
+        }
+    }
+    // 4. Update flows with steps referencing this module
+    for (const id of store.listFlows()) {
+        const flow = store.readFlow(id);
+        let changed = false;
+        if (flow.steps) {
+            for (const step of flow.steps) {
+                if (step.module === oldId) {
+                    step.module = newId;
+                    changed = true;
+                }
+            }
+        }
+        if (changed) {
+            store.writeFlow(flow);
+            updatedFiles.push(`flows/${id}.yaml`);
+        }
+    }
+    // 5. Update concepts with layer referencing this module
+    for (const id of store.listConcepts()) {
+        const concept = store.readConcept(id);
+        if (concept.layer === oldId) {
+            concept.layer = newId;
+            store.writeConcept(concept);
+            updatedFiles.push(`concepts/${id}.yaml`);
+        }
+    }
+    rebuildDerivedIndex(store);
+    CotxGraph.invalidateCache();
+    return {
+        success: true,
+        message: `Renamed module "${oldId}" → "${newId}" (${updatedFiles.length} files updated)`,
+        updatedFiles,
+    };
+}
+//# sourceMappingURL=rename.js.map

package/dist/commands/rename.js.map

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

package/dist/commands/snapshot.d.ts

@@ -0,0 +1,6 @@
+export declare function commandSnapshot(projectRoot: string, options: {
+    tag: string;
+}): Promise<{
+    success: boolean;
+    message: string;
+}>;

package/dist/commands/snapshot.js

@@ -0,0 +1,48 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { CotxStore } from '../store/store.js';
+export async function commandSnapshot(projectRoot, options) {
+    const store = new CotxStore(projectRoot);
+    if (!store.exists()) {
+        return { success: false, message: 'No .cotx/ found. Run: cotx compile' };
+    }
+    const tag = options.tag;
+    if (!tag || !/^[a-zA-Z0-9_-]+$/.test(tag)) {
+        return { success: false, message: 'Invalid tag. Use alphanumeric, dash, or underscore.' };
+    }
+    const cotxDir = path.join(projectRoot, '.cotx');
+    const snapshotDir = path.join(cotxDir, 'snapshots', tag);
+    if (fs.existsSync(snapshotDir)) {
+        return { success: false, message: `Snapshot "${tag}" already exists.` };
+    }
+    // Copy these directories: concepts/, modules/, contracts/, flows/, concerns/
+    // Copy these files: meta.yaml, index.json
+    // Do NOT copy: graph/ (large, can be recomputed), snapshots/ (avoid nesting), log.jsonl
+    const dirsToCopy = ['concepts', 'modules', 'contracts', 'flows', 'concerns'];
+    const filesToCopy = ['meta.yaml', 'index.json'];
+    fs.mkdirSync(snapshotDir, { recursive: true });
+    // Copy directories
+    for (const dir of dirsToCopy) {
+        const srcDir = path.join(cotxDir, dir);
+        const dstDir = path.join(snapshotDir, dir);
+        if (fs.existsSync(srcDir)) {
+            fs.mkdirSync(dstDir, { recursive: true });
+            for (const file of fs.readdirSync(srcDir)) {
+                fs.copyFileSync(path.join(srcDir, file), path.join(dstDir, file));
+            }
+        }
+    }
+    // Copy files
+    for (const file of filesToCopy) {
+        const src = path.join(cotxDir, file);
+        if (fs.existsSync(src)) {
+            fs.copyFileSync(src, path.join(snapshotDir, file));
+        }
+    }
+    const stats = store.readMeta().stats;
+    return {
+        success: true,
+        message: `Snapshot "${tag}" saved (${stats.modules} modules, ${stats.concepts} concepts, ${stats.contracts} contracts, ${stats.flows} flows)`,
+    };
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/commands/snapshot.js.map

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

package/dist/commands/status.d.ts

@@ -0,0 +1 @@
+export declare function commandStatus(projectRoot: string): Promise<void>;

package/dist/commands/status.js

@@ -0,0 +1,72 @@
+import { CotxStore } from '../store/store.js';
+export async function commandStatus(projectRoot) {
+    const store = new CotxStore(projectRoot);
+    if (!store.exists()) {
+        console.log('No .cotx/ found. Run: cotx init && cotx compile');
+        return;
+    }
+    const meta = store.readMeta();
+    console.log(`Project: ${meta.project}`);
+    console.log(`Version: ${meta.version}`);
+    console.log(`Last compiled: ${meta.compiled_at}`);
+    console.log(`Resolution: ${meta.module_resolution}`);
+    console.log(`Stats:`);
+    console.log(`  Modules:   ${meta.stats.modules}`);
+    console.log(`  Concepts:  ${meta.stats.concepts}`);
+    console.log(`  Contracts: ${meta.stats.contracts}`);
+    console.log(`  Flows:     ${meta.stats.flows}`);
+    console.log(`  Concerns:  ${meta.stats.concerns}`);
+    // Enrichment coverage
+    const modules = store.listModules();
+    let enrichedModules = 0;
+    let staleCount = 0;
+    for (const modId of modules) {
+        const mod = store.readModule(modId);
+        if (mod.enriched) {
+            enrichedModules++;
+            if (mod.enriched.source_hash !== mod.struct_hash) {
+                staleCount++;
+            }
+        }
+    }
+    const conceptIds = store.listConcepts();
+    let enrichedConcepts = 0;
+    for (const cid of conceptIds) {
+        const concept = store.readConcept(cid);
+        if (concept.enriched)
+            enrichedConcepts++;
+    }
+    console.log(`Enrichment:`);
+    console.log(`  Modules:  ${enrichedModules}/${modules.length} enriched`);
+    console.log(`  Concepts: ${enrichedConcepts}/${conceptIds.length} enriched`);
+    if (staleCount > 0) {
+        console.log(`  Stale:    ${staleCount}`);
+    }
+    // Count stale annotations
+    let staleAnnotationCount = 0;
+    for (const modId of modules) {
+        const mod = store.readModule(modId);
+        if (mod.annotations) {
+            staleAnnotationCount += mod.annotations.filter((a) => a.stale).length;
+        }
+    }
+    for (const id of store.listConcepts()) {
+        const node = store.readConcept(id);
+        if (node.annotations)
+            staleAnnotationCount += node.annotations.filter((a) => a.stale).length;
+    }
+    for (const id of store.listContracts()) {
+        const node = store.readContract(id);
+        if (node.annotations)
+            staleAnnotationCount += node.annotations.filter((a) => a.stale).length;
+    }
+    for (const id of store.listFlows()) {
+        const node = store.readFlow(id);
+        if (node.annotations)
+            staleAnnotationCount += node.annotations.filter((a) => a.stale).length;
+    }
+    if (staleAnnotationCount > 0) {
+        console.log(`  Stale annotations: ${staleAnnotationCount}`);
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

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

package/dist/commands/update.d.ts

@@ -0,0 +1,8 @@
+export declare function commandUpdate(projectRoot: string, files?: string[], options?: {
+    silent?: boolean;
+}): Promise<{
+    updatedModules: number;
+    updatedContracts: number;
+    updatedFlows: number;
+    staleEnrichments: number;
+}>;

package/dist/commands/update.js

@@ -0,0 +1,163 @@
+import { CotxStore } from '../store/store.js';
+import { detectDelta } from '../compiler/delta-detector.js';
+import { compileModules } from '../compiler/module-compiler.js';
+import { compileConcepts } from '../compiler/concept-compiler.js';
+import { compileContracts } from '../compiler/contract-compiler.js';
+import { compileFlows } from '../compiler/flow-compiler.js';
+import { autoDescribeModules } from '../compiler/auto-describe.js';
+import { detectStale, markStaleAnnotations } from '../compiler/stale-detector.js';
+import { exportGraphToJsonLines, exportCommunitiesToJsonLines, exportProcessesToJsonLines, } from '../core/export/json-exporter.js';
+import { runPipelineFromRepo } from '../core/parser/pipeline.js';
+import { bridgeNodes, bridgeEdges, bridgeCommunities, bridgeProcesses, } from '../core/bridge.js';
+import { rebuildDerivedIndex } from '../store/derived-index.js';
+import { CotxGraph } from '../query/graph-index.js';
+import { execSync } from 'node:child_process';
+export async function commandUpdate(projectRoot, files, options) {
+    const store = new CotxStore(projectRoot);
+    const log = options?.silent ? (() => { }) : console.log.bind(console);
+    if (!store.exists()) {
+        log('No .cotx/ found. Run: cotx compile');
+        return { updatedModules: 0, updatedContracts: 0, updatedFlows: 0, staleEnrichments: 0 };
+    }
+    // Detect changed files
+    let changedFiles = files ?? [];
+    if (changedFiles.length === 0) {
+        // Auto-detect from git diff (unstaged + staged)
+        try {
+            const diff = execSync('git diff --name-only HEAD', { cwd: projectRoot, encoding: 'utf-8' });
+            const staged = execSync('git diff --cached --name-only', { cwd: projectRoot, encoding: 'utf-8' });
+            changedFiles = [
+                ...new Set([
+                    ...diff.trim().split('\n'),
+                    ...staged.trim().split('\n'),
+                ]),
+            ].filter(Boolean);
+        }
+        catch {
+            log('Could not detect changed files from git. Specify files explicitly: cotx update <file1> <file2>');
+            return { updatedModules: 0, updatedContracts: 0, updatedFlows: 0, staleEnrichments: 0 };
+        }
+    }
+    if (changedFiles.length === 0) {
+        log('No changed files detected.');
+        return { updatedModules: 0, updatedContracts: 0, updatedFlows: 0, staleEnrichments: 0 };
+    }
+    log(`Updating ${changedFiles.length} changed file(s)...`);
+    const startTime = Date.now();
+    // Find affected nodes BEFORE recompile (uses current store state)
+    const delta = detectDelta(store, changedFiles);
+    if (delta.affectedModules.length === 0) {
+        log('No previously claimed semantic nodes matched. Continuing full refresh to catch new or moved files.');
+    }
+    // Run full pipeline (fast enough — < 7s on GoalX)
+    const result = await runPipelineFromRepo(projectRoot, (p) => {
+        if (!options?.silent && p.message)
+            process.stdout.write(`\r  ${p.message}`);
+    });
+    if (!options?.silent)
+        process.stdout.write('\n');
+    const nodes = bridgeNodes(result.graph);
+    const edges = bridgeEdges(result.graph);
+    const communities = bridgeCommunities(result.communityResult);
+    const processes = bridgeProcesses(result.processResult);
+    const compiledAt = new Date().toISOString();
+    // Recompile all layers (needed for correct cross-module dependencies)
+    const allModules = compileModules(nodes, edges, communities);
+    const allConcepts = compileConcepts(nodes, allModules);
+    const allContracts = compileContracts(nodes, edges, allModules);
+    const allFlows = compileFlows(processes, nodes, allModules);
+    const previousModuleHashes = new Map(store.listModules().map((id) => [id, store.readModule(id).struct_hash]));
+    const previousContractHashes = new Map(store.listContracts().map((id) => [id, store.readContract(id).struct_hash]));
+    const previousFlowHashes = new Map(store.listFlows().map((id) => [id, store.readFlow(id).struct_hash]));
+    const previousConceptHashes = new Map(store.listConcepts().map((id) => [id, store.readConcept(id).struct_hash]));
+    // Refresh graph files
+    const graphExport = exportGraphToJsonLines({ nodes, edges });
+    store.writeGraphFile('nodes.json', graphExport.nodes);
+    store.writeGraphFile('edges.json', graphExport.edges);
+    store.writeGraphFile('communities.json', exportCommunitiesToJsonLines(communities));
+    store.writeGraphFile('processes.json', exportProcessesToJsonLines(processes));
+    store.writeGraphFile('meta.json', [
+        JSON.stringify({
+            compiled_at: compiledAt,
+            stats: {
+                nodes: nodes.length,
+                edges: edges.length,
+                communities: communities.length,
+                processes: processes.length,
+            },
+        }),
+    ]);
+    for (const mod of allModules) {
+        store.writeModule(mod);
+    }
+    store.pruneStale('modules', new Set(allModules.map((mod) => mod.id)));
+    autoDescribeModules(store, nodes, allModules);
+    for (const concept of allConcepts) {
+        store.writeConcept(concept);
+    }
+    store.pruneStale('concepts', new Set(allConcepts.map((concept) => concept.id)));
+    for (const contract of allContracts) {
+        store.writeContract(contract);
+    }
+    store.pruneStale('contracts', new Set(allContracts.map((contract) => contract.id)));
+    for (const flow of allFlows) {
+        store.writeFlow(flow);
+    }
+    store.pruneStale('flows', new Set(allFlows.map((flow) => flow.id)));
+    const changedNodeIds = new Set();
+    collectChangedIds(previousModuleHashes, allModules, changedNodeIds);
+    collectChangedIds(previousConceptHashes, allConcepts, changedNodeIds);
+    collectChangedIds(previousContractHashes, allContracts, changedNodeIds);
+    collectChangedIds(previousFlowHashes, allFlows, changedNodeIds);
+    markStaleAnnotations(store, changedNodeIds, 'struct_hash changed during update');
+    const updatedModules = countChanged(previousModuleHashes, allModules);
+    const updatedContracts = countChanged(previousContractHashes, allContracts);
+    const updatedFlows = countChanged(previousFlowHashes, allFlows);
+    const staleEnrichments = detectStale(store).summary.enrichments;
+    const concernCount = store.listConcerns().length;
+    // Update meta timestamp + stats
+    store.updateMeta({
+        compiled_at: compiledAt,
+        stats: {
+            concepts: allConcepts.length,
+            modules: allModules.length,
+            contracts: allContracts.length,
+            flows: allFlows.length,
+            concerns: concernCount,
+        },
+    });
+    rebuildDerivedIndex(store);
+    CotxGraph.invalidateCache();
+    const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+    store.appendLog({ operation: 'update', affected_nodes: [...delta.affectedModules], summary: `${updatedModules} modules, ${updatedContracts} contracts, ${updatedFlows} flows updated` });
+    log(`Updated in ${elapsed}s:`);
+    log(`  ${updatedModules} modules, ${updatedContracts} contracts, ${updatedFlows} flows`);
+    if (staleEnrichments > 0) {
+        log(`  ${staleEnrichments} stale enrichment(s) — run: cotx write <id> enriched.*`);
+    }
+    return { updatedModules, updatedContracts, updatedFlows, staleEnrichments };
+}
+function countChanged(previousHashes, nextNodes) {
+    const seenIds = new Set();
+    let changed = 0;
+    for (const node of nextNodes) {
+        seenIds.add(node.id);
+        if (previousHashes.get(node.id) !== node.struct_hash) {
+            changed++;
+        }
+    }
+    for (const id of previousHashes.keys()) {
+        if (!seenIds.has(id)) {
+            changed++;
+        }
+    }
+    return changed;
+}
+function collectChangedIds(previousHashes, nextNodes, changedIds) {
+    for (const node of nextNodes) {
+        if (previousHashes.get(node.id) !== node.struct_hash) {
+            changedIds.add(node.id);
+        }
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EACL,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAmB,EACnB,KAAgB,EAChB,OAA8B;IAE9B,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,WAAW,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAErE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QACpB,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAC1C,OAAO,EAAE,cAAc,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,CAAC;IAC1F,CAAC;IAED,uBAAuB;IACvB,IAAI,YAAY,GAAG,KAAK,IAAI,EAAE,CAAC;IAC/B,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,gDAAgD;QAChD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,QAAQ,CAAC,2BAA2B,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YAC5F,MAAM,MAAM,GAAG,QAAQ,CAAC,+BAA+B,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YAClG,YAAY,GAAG;gBACb,GAAG,IAAI,GAAG,CAAC;oBACT,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;oBAC1B,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;iBAC7B,CAAC;aACH,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,CACD,gGAAgG,CACjG,CAAC;YACF,OAAO,EAAE,cAAc,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,CAAC;QAC1F,CAAC;IACH,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAClC,OAAO,EAAE,cAAc,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,CAAC;IAC1F,CAAC;IAED,GAAG,CAAC,YAAY,YAAY,CAAC,MAAM,qBAAqB,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,kEAAkE;IAClE,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAE/C,IAAI,KAAK,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,oGAAoG,CAAC,CAAC;IAC5G,CAAC;IAED,kDAAkD;IAClD,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE;QAC1D,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC,OAAO;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,OAAO,EAAE,MAAM;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEjD,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE5C,sEAAsE;IACtE,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IAC7D,MAAM,WAAW,GAAG,eAAe,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACvD,MAAM,YAAY,GAAG,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAE5D,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAClC,KAAK,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CACxE,CAAC;IACF,MAAM,sBAAsB,GAAG,IAAI,GAAG,CACpC,KAAK,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAC5E,CAAC;IACF,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAChC,KAAK,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CACpE,CAAC;IACF,MAAM,qBAAqB,GAAG,IAAI,GAAG,CACnC,KAAK,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAC1E,CAAC;IAEF,sBAAsB;IACtB,MAAM,WAAW,GAAG,sBAAsB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,KAAK,CAAC,cAAc,CAAC,YAAY,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;IACtD,KAAK,CAAC,cAAc,CAAC,YAAY,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;IACtD,KAAK,CAAC,cAAc,CAAC,kBAAkB,EAAE,4BAA4B,CAAC,WAAW,CAAC,CAAC,CAAC;IACpF,KAAK,CAAC,cAAc,CAAC,gBAAgB,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9E,KAAK,CAAC,cAAc,CAAC,WAAW,EAAE;QAChC,IAAI,CAAC,SAAS,CAAC;YACb,WAAW,EAAE,UAAU;YACvB,KAAK,EAAE;gBACL,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,WAAW,EAAE,WAAW,CAAC,MAAM;gBAC/B,SAAS,EAAE,SAAS,CAAC,MAAM;aAC5B;SACF,CAAC;KACH,CAAC,CAAC;IAEH,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IACD,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtE,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAE9C,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;QAClC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,KAAK,CAAC,UAAU,CAAC,UAAU,EAAE,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAEhF,KAAK,MAAM,QAAQ,IAAI,YAAY,EAAE,CAAC;QACpC,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IACD,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAEpF,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAEpE,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,iBAAiB,CAAC,oBAAoB,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;IACpE,iBAAiB,CAAC,qBAAqB,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;IACtE,iBAAiB,CAAC,sBAAsB,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;IACxE,iBAAiB,CAAC,kBAAkB,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;IAChE,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,mCAAmC,CAAC,CAAC;IAEjF,MAAM,cAAc,GAAG,YAAY,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;IACtE,MAAM,gBAAgB,GAAG,YAAY,CAAC,sBAAsB,EAAE,YAAY,CAAC,CAAC;IAC5E,MAAM,YAAY,GAAG,YAAY,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;IAChE,MAAM,gBAAgB,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAChE,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC;IAEjD,gCAAgC;IAChC,KAAK,CAAC,UAAU,CAAC;QACf,WAAW,EAAE,UAAU;QACvB,KAAK,EAAE;YACL,QAAQ,EAAE,WAAW,CAAC,MAAM;YAC5B,OAAO,EAAE,UAAU,CAAC,MAAM;YAC1B,SAAS,EAAE,YAAY,CAAC,MAAM;YAC9B,KAAK,EAAE,QAAQ,CAAC,MAAM;YACtB,QAAQ,EAAE,YAAY;SACvB;KACF,CAAC,CAAC;IACH,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC3B,SAAS,CAAC,eAAe,EAAE,CAAC;IAE5B,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAE7D,KAAK,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,GAAG,cAAc,aAAa,gBAAgB,eAAe,YAAY,gBAAgB,EAAE,CAAC,CAAC;IAEzL,GAAG,CAAC,cAAc,OAAO,IAAI,CAAC,CAAC;IAC/B,GAAG,CAAC,KAAK,cAAc,aAAa,gBAAgB,eAAe,YAAY,QAAQ,CAAC,CAAC;IACzF,IAAI,gBAAgB,GAAG,CAAC,EAAE,CAAC;QACzB,GAAG,CAAC,KAAK,gBAAgB,wDAAwD,CAAC,CAAC;IACrF,CAAC;IAED,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CACnB,cAAmC,EACnC,SAAqD;IAErD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrB,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;YACrD,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC;QACvC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACrB,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,iBAAiB,CACxB,cAAmC,EACnC,SAAqD,EACrD,UAAuB;IAEvB,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;YACrD,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/commands/write.d.ts

@@ -0,0 +1,6 @@
+export declare function commandWrite(projectRoot: string, nodeId: string, field: string, content: string, options?: {
+    author?: 'human' | 'agent';
+}): Promise<{
+    success: boolean;
+    message: string;
+}>;