@jamesaphoenix/tx-cli 0.4.3

package/dist/commands/doc.js

@@ -0,0 +1,397 @@
+/**
+ * Doc commands: doc add, doc edit, doc show, doc list, doc render, doc lock,
+ * doc version, doc link, doc attach, doc patch, doc validate, doc drift
+ */
+import { Effect } from "effect";
+import { readFileSync } from "node:fs";
+import { execSync } from "node:child_process";
+import { DocService } from "@jamesaphoenix/tx-core";
+import { DOC_KINDS } from "@jamesaphoenix/tx-types";
+import { toJson } from "../output.js";
+import { flag, opt } from "../utils/parse.js";
+const docKindStrings = DOC_KINDS;
+/** Dispatch doc subcommands. */
+export const doc = (pos, flags) => {
+    const sub = pos[0];
+    const rest = pos.slice(1);
+    switch (sub) {
+        case "add": return docAdd(rest, flags);
+        case "edit": return docEdit(rest, flags);
+        case "show": return docShow(rest, flags);
+        case "list": return docList(rest, flags);
+        case "render": return docRender(rest, flags);
+        case "lock": return docLock(rest, flags);
+        case "version": return docVersion(rest, flags);
+        case "link": return docLink(rest, flags);
+        case "attach": return docAttach(rest, flags);
+        case "patch": return docPatch(rest, flags);
+        case "validate": return docValidate(rest, flags);
+        case "drift": return docDrift(rest, flags);
+        default:
+            return Effect.sync(() => {
+                console.error(`Unknown doc subcommand: ${sub ?? "(none)"}`);
+                console.error("Run 'tx doc --help' for usage information");
+                process.exit(1);
+            });
+    }
+};
+const docAdd = (pos, flags) => Effect.gen(function* () {
+    const kind = pos[0];
+    const name = pos[1];
+    if (!kind || !name) {
+        console.error("Usage: tx doc add <kind> <name> [--title <title>]");
+        console.error("  Kinds: overview, prd, design");
+        process.exit(1);
+    }
+    if (!docKindStrings.includes(kind)) {
+        console.error(`Invalid kind: ${kind}. Must be one of: ${DOC_KINDS.join(", ")}`);
+        process.exit(1);
+    }
+    const title = opt(flags, "title", "t") ?? name;
+    // Generate template YAML
+    const yamlContent = generateTemplate(kind, name, title);
+    const svc = yield* DocService;
+    const doc = yield* svc.create({
+        kind: kind,
+        name,
+        title,
+        yamlContent,
+    });
+    if (flag(flags, "json")) {
+        console.log(toJson(doc));
+    }
+    else {
+        console.log(`Created doc: ${doc.name} (${doc.kind} v${doc.version})`);
+        console.log(`  File: ${doc.filePath}`);
+        console.log(`  Hash: ${doc.hash.slice(0, 12)}...`);
+    }
+});
+const docEdit = (pos, _flags) => Effect.gen(function* () {
+    const name = pos[0];
+    if (!name) {
+        console.error("Usage: tx doc edit <name>");
+        process.exit(1);
+    }
+    const svc = yield* DocService;
+    const doc = yield* svc.get(name);
+    const editor = process.env.EDITOR ?? "vi";
+    const docsPath = doc.filePath;
+    try {
+        execSync(`${editor} "${docsPath}"`, { stdio: "inherit" });
+    }
+    catch {
+        console.error(`Failed to open editor: ${editor}`);
+        process.exit(1);
+    }
+});
+const docShow = (pos, flags) => Effect.gen(function* () {
+    const name = pos[0];
+    if (!name) {
+        console.error("Usage: tx doc show <name> [--md] [--json]");
+        process.exit(1);
+    }
+    const svc = yield* DocService;
+    const doc = yield* svc.get(name);
+    if (flag(flags, "json")) {
+        console.log(toJson(doc));
+    }
+    else if (flag(flags, "md")) {
+        // Render and show MD
+        const rendered = yield* svc.render(name);
+        if (rendered.length > 0) {
+            console.log(readFileSync(rendered[0], "utf8"));
+        }
+    }
+    else {
+        console.log(`Doc: ${doc.name}`);
+        console.log(`  Kind: ${doc.kind}`);
+        console.log(`  Title: ${doc.title}`);
+        console.log(`  Version: ${doc.version}`);
+        console.log(`  Status: ${doc.status}`);
+        console.log(`  Hash: ${doc.hash.slice(0, 12)}...`);
+        console.log(`  File: ${doc.filePath}`);
+        console.log(`  Created: ${doc.createdAt.toISOString()}`);
+        if (doc.lockedAt)
+            console.log(`  Locked: ${doc.lockedAt.toISOString()}`);
+        if (doc.parentDocId)
+            console.log(`  Parent doc ID: ${doc.parentDocId}`);
+    }
+});
+const docList = (_pos, flags) => Effect.gen(function* () {
+    const kind = opt(flags, "kind", "k");
+    const status = opt(flags, "status", "s");
+    const svc = yield* DocService;
+    const docs = yield* svc.list({ kind, status });
+    if (flag(flags, "json")) {
+        console.log(toJson(docs));
+    }
+    else {
+        if (docs.length === 0) {
+            console.log("No docs found");
+        }
+        else {
+            console.log(`${docs.length} doc(s):`);
+            for (const d of docs) {
+                const statusIcon = d.status === "locked" ? "🔒" : "📝";
+                console.log(`  ${statusIcon} ${d.name} (${d.kind} v${d.version}) [${d.status}] ${d.title}`);
+            }
+        }
+    }
+});
+const docRender = (pos, flags) => Effect.gen(function* () {
+    const name = pos[0] || undefined;
+    const svc = yield* DocService;
+    const rendered = yield* svc.render(name);
+    if (flag(flags, "json")) {
+        console.log(toJson({ rendered }));
+    }
+    else {
+        if (rendered.length === 0) {
+            console.log("No docs rendered");
+        }
+        else {
+            console.log(`Rendered ${rendered.length} doc(s):`);
+            for (const path of rendered) {
+                console.log(`  ${path}`);
+            }
+            console.log("  + index.yml, index.md");
+        }
+    }
+});
+const docLock = (pos, flags) => Effect.gen(function* () {
+    const name = pos[0];
+    if (!name) {
+        console.error("Usage: tx doc lock <name>");
+        process.exit(1);
+    }
+    const svc = yield* DocService;
+    const doc = yield* svc.lock(name);
+    // Render final MD
+    yield* svc.render(name);
+    if (flag(flags, "json")) {
+        console.log(toJson(doc));
+    }
+    else {
+        console.log(`Locked: ${doc.name} v${doc.version}`);
+        console.log(`  Status: ${doc.status}`);
+        if (doc.lockedAt)
+            console.log(`  Locked at: ${doc.lockedAt.toISOString()}`);
+    }
+});
+const docVersion = (pos, flags) => Effect.gen(function* () {
+    const name = pos[0];
+    if (!name) {
+        console.error("Usage: tx doc version <name>");
+        process.exit(1);
+    }
+    const svc = yield* DocService;
+    const doc = yield* svc.createVersion(name);
+    if (flag(flags, "json")) {
+        console.log(toJson(doc));
+    }
+    else {
+        console.log(`Created version: ${doc.name} v${doc.version}`);
+        console.log(`  Copied from v${doc.version - 1}`);
+        console.log(`  Status: ${doc.status}`);
+    }
+});
+const docLink = (pos, flags) => Effect.gen(function* () {
+    const from = pos[0];
+    const to = pos[1];
+    if (!from || !to) {
+        console.error("Usage: tx doc link <from-name> <to-name> [--type <link-type>]");
+        process.exit(1);
+    }
+    const linkType = opt(flags, "type");
+    const svc = yield* DocService;
+    const link = yield* svc.linkDocs(from, to, linkType);
+    if (flag(flags, "json")) {
+        console.log(toJson(link));
+    }
+    else {
+        console.log(`Linked: ${from} → ${to} (${link.linkType})`);
+    }
+});
+const docAttach = (pos, flags) => Effect.gen(function* () {
+    const taskId = pos[0];
+    const docName = pos[1];
+    if (!taskId || !docName) {
+        console.error("Usage: tx doc attach <task-id> <doc-name> [--type implements|references]");
+        process.exit(1);
+    }
+    const linkType = (opt(flags, "type") ?? "implements");
+    const svc = yield* DocService;
+    yield* svc.attachTask(taskId, docName, linkType);
+    if (flag(flags, "json")) {
+        console.log(toJson({ taskId, docName, linkType }));
+    }
+    else {
+        console.log(`Attached: task ${taskId} → doc ${docName} (${linkType})`);
+    }
+});
+const docPatch = (pos, flags) => Effect.gen(function* () {
+    const designName = pos[0];
+    const patchName = pos[1];
+    if (!designName || !patchName) {
+        console.error("Usage: tx doc patch <design-name> <patch-name> [--title <title>]");
+        process.exit(1);
+    }
+    const title = opt(flags, "title", "t") ?? patchName;
+    const svc = yield* DocService;
+    const doc = yield* svc.createPatch(designName, patchName, title);
+    if (flag(flags, "json")) {
+        console.log(toJson(doc));
+    }
+    else {
+        console.log(`Created patch: ${doc.name} → ${designName}`);
+        console.log(`  Title: ${doc.title}`);
+        console.log(`  File: ${doc.filePath}`);
+    }
+});
+const docValidate = (_pos, flags) => Effect.gen(function* () {
+    const svc = yield* DocService;
+    const warnings = yield* svc.validate();
+    if (flag(flags, "json")) {
+        console.log(toJson({ warnings }));
+    }
+    else {
+        if (warnings.length === 0) {
+            console.log("All tasks are linked to docs");
+        }
+        else {
+            console.log(`${warnings.length} warning(s):`);
+            for (const w of warnings) {
+                console.log(`  ⚠ ${w}`);
+            }
+        }
+    }
+});
+const docDrift = (pos, flags) => Effect.gen(function* () {
+    const name = pos[0];
+    if (!name) {
+        console.error("Usage: tx doc drift <name>");
+        process.exit(1);
+    }
+    const svc = yield* DocService;
+    const warnings = yield* svc.detectDrift(name);
+    if (flag(flags, "json")) {
+        console.log(toJson({ name, warnings }));
+    }
+    else {
+        if (warnings.length === 0) {
+            console.log(`No drift detected for: ${name}`);
+        }
+        else {
+            console.log(`${warnings.length} drift warning(s) for ${name}:`);
+            for (const w of warnings) {
+                console.log(`  ⚠ ${w}`);
+            }
+        }
+    }
+});
+/** Generate template YAML content for a doc kind. */
+function generateTemplate(kind, name, title) {
+    switch (kind) {
+        case "overview":
+            return [
+                `kind: overview`,
+                `name: ${name}`,
+                `title: "${title}"`,
+                ``,
+                `problem_definition: |`,
+                `  Describe the problem this system solves.`,
+                ``,
+                `subsystems: |`,
+                `  ## Subsystem 1`,
+                `  - Boundary: packages/core/src/services/...`,
+                ``,
+                `object_model: |`,
+                `  ## Entity`,
+                `  - Table: ...`,
+                `  - Lifecycle: ...`,
+                ``,
+                `storage_schema: |`,
+                `  ## Table Name`,
+                `  | Column | Type | Constraints |`,
+                `  |--------|------|-------------|`,
+                ``,
+                `invariants: []`,
+                ``,
+                `failure_modes: []`,
+                ``,
+                `edge_cases: []`,
+                ``,
+                `constraints: []`,
+                ``,
+                `cross_cutting: |`,
+                `  - Error handling: ...`,
+                ``,
+                `data_retention: |`,
+                `  - Retained indefinitely`,
+                ``,
+            ].join("\n");
+        case "prd":
+            return [
+                `kind: prd`,
+                `name: ${name}`,
+                `title: "${title}"`,
+                `status: changing`,
+                ``,
+                `problem: |`,
+                `  Describe the problem.`,
+                ``,
+                `solution: |`,
+                `  Describe the solution approach.`,
+                ``,
+                `requirements:`,
+                `  - Requirement 1`,
+                ``,
+                `acceptance_criteria:`,
+                `  - Criterion 1`,
+                ``,
+                `out_of_scope:`,
+                `  - Item 1`,
+                ``,
+            ].join("\n");
+        case "design":
+            return [
+                `kind: design`,
+                `name: ${name}`,
+                `title: "${title}"`,
+                `status: changing`,
+                `version: 1`,
+                ``,
+                `problem_definition: |`,
+                `  Why this change is needed.`,
+                ``,
+                `goals:`,
+                `  - Goal 1`,
+                ``,
+                `architecture: |`,
+                `  ## Components`,
+                `  ...`,
+                ``,
+                `data_model: |`,
+                `  ## Table Name`,
+                `  | Column | Type | Constraints |`,
+                `  |--------|------|-------------|`,
+                ``,
+                `invariants: []`,
+                ``,
+                `failure_modes: []`,
+                ``,
+                `edge_cases: []`,
+                ``,
+                `work_breakdown:`,
+                `  - description: "Phase 1"`,
+                ``,
+                `retention: |`,
+                `  - docs: All versions retained`,
+                ``,
+                `testing_strategy: |`,
+                `  Shared test layer, integration tests.`,
+                ``,
+            ].join("\n");
+    }
+}
+//# sourceMappingURL=doc.js.map

package/dist/commands/doc.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Doctor command: System health diagnostics for troubleshooting
+ */
+import { Effect } from "effect";
+import { SqliteClient, MigrationService } from "@jamesaphoenix/tx-core";
+type Flags = Record<string, string | boolean>;
+export declare const doctor: (_pos: string[], flags: Flags) => Effect.Effect<void, import("@jamesaphoenix/tx-core").DatabaseError, MigrationService | SqliteClient>;
+export {};
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAIvE,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAA;AA8C7C,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,EAAE,EAAE,OAAO,KAAK,yGAsJ/C,CAAA"}

package/dist/commands/doctor.js

@@ -0,0 +1,168 @@
+/**
+ * Doctor command: System health diagnostics for troubleshooting
+ */
+import { Effect } from "effect";
+import { SqliteClient, MigrationService } from "@jamesaphoenix/tx-core";
+import { toJson } from "../output.js";
+import { statSync } from "node:fs";
+function flag(flags, ...names) {
+    return names.some(n => flags[n] === true);
+}
+function statusIcon(status) {
+    switch (status) {
+        case "pass": return "\u2713";
+        case "warn": return "\u26a0";
+        case "fail": return "\u2717";
+    }
+}
+function formatDoctorResult(result, verbose) {
+    const lines = [];
+    for (const check of result.checks) {
+        lines.push(`${statusIcon(check.status)} ${check.message}`);
+        if (verbose && check.details) {
+            lines.push(`    ${check.details}`);
+        }
+    }
+    lines.push("");
+    if (result.healthy) {
+        lines.push("All checks passed.");
+    }
+    else {
+        lines.push("Issues detected. Run with --verbose for details.");
+    }
+    return lines.join("\n");
+}
+export const doctor = (_pos, flags) => Effect.gen(function* () {
+    const db = yield* SqliteClient;
+    const migrationSvc = yield* MigrationService;
+    const verbose = flag(flags, "verbose", "v");
+    const checks = [];
+    // 1. Check database file exists and is readable
+    const dbPath = typeof flags.db === "string" ? flags.db : undefined;
+    if (dbPath) {
+        try {
+            const stats = statSync(dbPath);
+            const sizeMb = (stats.size / (1024 * 1024)).toFixed(1);
+            checks.push({
+                name: "database",
+                status: "pass",
+                message: `Database: ${dbPath} (${sizeMb}MB)`,
+            });
+        }
+        catch {
+            checks.push({
+                name: "database",
+                status: "fail",
+                message: `Database: ${dbPath} (not found or unreadable)`,
+            });
+        }
+    }
+    else {
+        // db path not available as flag — just confirm connection works
+        checks.push({
+            name: "database",
+            status: "pass",
+            message: "Database: connected",
+        });
+    }
+    // 2. Verify WAL mode enabled
+    const walRow = db.prepare("PRAGMA journal_mode").get();
+    const walMode = walRow?.journal_mode === "wal";
+    checks.push({
+        name: "wal_mode",
+        status: walMode ? "pass" : "warn",
+        message: walMode
+            ? "WAL mode: enabled"
+            : `WAL mode: disabled (journal_mode=${walRow?.journal_mode ?? "unknown"})`,
+        details: walMode ? undefined : "WAL mode improves concurrent read/write performance. Expected 'wal'.",
+    });
+    // 3. Check schema version matches expected
+    const migrationStatus = yield* migrationSvc.getStatus();
+    const schemaOk = migrationStatus.currentVersion === migrationStatus.latestVersion;
+    checks.push({
+        name: "schema",
+        status: schemaOk ? "pass" : migrationStatus.currentVersion < migrationStatus.latestVersion ? "warn" : "fail",
+        message: schemaOk
+            ? `Schema: v${migrationStatus.currentVersion} (current)`
+            : `Schema: v${migrationStatus.currentVersion} (latest: v${migrationStatus.latestVersion})`,
+        details: !schemaOk && migrationStatus.pendingCount > 0
+            ? `${migrationStatus.pendingCount} pending migration(s). Run tx migrate to apply.`
+            : undefined,
+    });
+    // 4. Verify Effect services are properly wired (we already have db + migrationSvc)
+    checks.push({
+        name: "services",
+        status: "pass",
+        message: "Effect services: wired correctly",
+    });
+    // 5. Check for stale claims/workers
+    const staleClaims = db.prepare(`SELECT COUNT(*) as count FROM task_claims
+       WHERE status = 'active'
+       AND datetime(lease_expires_at) < datetime('now')`).get();
+    const staleClaimCount = staleClaims?.count ?? 0;
+    const deadWorkers = db.prepare(`SELECT COUNT(*) as count FROM workers
+       WHERE status NOT IN ('dead', 'stopping')
+       AND datetime(last_heartbeat_at, '+5 minutes') < datetime('now')`).get();
+    const deadWorkerCount = deadWorkers?.count ?? 0;
+    if (staleClaimCount > 0 || deadWorkerCount > 0) {
+        const parts = [];
+        if (staleClaimCount > 0)
+            parts.push(`${staleClaimCount} expired claim(s)`);
+        if (deadWorkerCount > 0)
+            parts.push(`${deadWorkerCount} stale worker(s)`);
+        checks.push({
+            name: "stale_claims",
+            status: "warn",
+            message: `Stale claims/workers: ${parts.join(", ")}`,
+            details: "Stale claims will auto-expire. Dead workers can be cleaned up via the worker API.",
+        });
+    }
+    else {
+        checks.push({
+            name: "stale_claims",
+            status: "pass",
+            message: "Claims/workers: no stale entries",
+        });
+    }
+    // 6. Report database size and task counts
+    const taskCounts = db.prepare("SELECT status, COUNT(*) as count FROM tasks GROUP BY status").all();
+    const totalTasks = taskCounts.reduce((sum, r) => sum + r.count, 0);
+    const readyCount = taskCounts.find(r => r.status === "ready")?.count ?? 0;
+    const doneCount = taskCounts.find(r => r.status === "done")?.count ?? 0;
+    const learningCount = db.prepare("SELECT COUNT(*) as count FROM learnings").get();
+    checks.push({
+        name: "tasks",
+        status: "pass",
+        message: `Tasks: ${totalTasks} total (${readyCount} ready, ${doneCount} done)`,
+        details: verbose
+            ? taskCounts.map(r => `${r.status}: ${r.count}`).join(", ")
+            : undefined,
+    });
+    checks.push({
+        name: "learnings",
+        status: "pass",
+        message: `Learnings: ${learningCount?.count ?? 0} total`,
+    });
+    // 7. Verify ANTHROPIC_API_KEY for LLM features
+    const hasApiKey = !!process.env.ANTHROPIC_API_KEY;
+    checks.push({
+        name: "api_key",
+        status: hasApiKey ? "pass" : "warn",
+        message: hasApiKey
+            ? "ANTHROPIC_API_KEY: set"
+            : "ANTHROPIC_API_KEY: not set (LLM features unavailable)",
+        details: hasApiKey ? undefined : "Required for: tx compact, tx dedupe, tx reprioritize",
+    });
+    const healthy = checks.every(c => c.status !== "fail");
+    const result = { healthy, checks };
+    if (flag(flags, "json")) {
+        console.log(toJson(result));
+    }
+    else {
+        console.log(formatDoctorResult(result, verbose));
+    }
+    if (!healthy) {
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/graph.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Graph commands: graph:verify, graph:invalidate, graph:restore, graph:prune, graph:status, graph:pin, graph:unpin,
+ * graph:link, graph:show, graph:neighbors
+ */
+import { Effect } from "effect";
+import { AnchorService, EdgeService } from "@jamesaphoenix/tx-core";
+import { type Flags } from "../utils/parse.js";
+/**
+ * tx graph:verify [--file <path>] [--all] [--json]
+ * Verify anchors for a specific file or all anchors
+ */
+export declare const graphVerify: (pos: string[], flags: Flags) => Effect.Effect<void, import("@jamesaphoenix/tx-core").DatabaseError, AnchorService>;
+/**
+ * tx graph:invalidate <anchor-id> --reason <reason> [--json]
+ * Manually invalidate an anchor
+ */
+export declare const graphInvalidate: (pos: string[], flags: Flags) => Effect.Effect<void, import("@jamesaphoenix/tx-core").DatabaseError | import("@jamesaphoenix/tx-core").AnchorNotFoundError, AnchorService>;
+/**
+ * tx graph:restore <anchor-id> [--json]
+ * Restore a soft-deleted (invalid) anchor
+ */
+export declare const graphRestore: (pos: string[], flags: Flags) => Effect.Effect<void, import("@jamesaphoenix/tx-core").DatabaseError | import("@jamesaphoenix/tx-core").AnchorNotFoundError, AnchorService>;
+/**
+ * tx graph:prune [--older-than <days>] [--json]
+ * Hard delete old invalid anchors
+ */
+export declare const graphPrune: (_pos: string[], flags: Flags) => Effect.Effect<void, import("@jamesaphoenix/tx-core").DatabaseError, AnchorService>;
+/**
+ * tx graph:status [--json]
+ * Show graph health metrics
+ */
+export declare const graphStatus: (_pos: string[], flags: Flags) => Effect.Effect<void, import("@jamesaphoenix/tx-core").DatabaseError, AnchorService>;
+/**
+ * tx graph:pin <anchor-id> [--json]
+ * Pin an anchor to prevent auto-invalidation
+ */
+export declare const graphPin: (pos: string[], flags: Flags) => Effect.Effect<void, import("@jamesaphoenix/tx-core").DatabaseError | import("@jamesaphoenix/tx-core").AnchorNotFoundError, AnchorService>;
+/**
+ * tx graph:unpin <anchor-id> [--json]
+ * Unpin an anchor to allow auto-invalidation
+ */
+export declare const graphUnpin: (pos: string[], flags: Flags) => Effect.Effect<void, import("@jamesaphoenix/tx-core").DatabaseError | import("@jamesaphoenix/tx-core").AnchorNotFoundError, AnchorService>;
+/**
+ * tx graph:link <learning-id> <file-path> [--type glob|hash|symbol] [--value <value>] [--json]
+ * Create an anchor linking a learning to a file
+ */
+export declare const graphLink: (pos: string[], flags: Flags) => Effect.Effect<void, import("@jamesaphoenix/tx-core").ValidationError | import("@jamesaphoenix/tx-core").DatabaseError | import("@jamesaphoenix/tx-core").LearningNotFoundError, AnchorService>;
+/**
+ * tx graph:show <learning-id> [--json]
+ * Show all edges for a learning
+ */
+export declare const graphShow: (pos: string[], flags: Flags) => Effect.Effect<void, import("@jamesaphoenix/tx-core").DatabaseError, AnchorService | EdgeService>;
+/**
+ * tx graph:neighbors <node-id> [--node-type learning|file|task|run] [--depth 2] [--edge-type IMPORTS,ANCHORED_TO] [--direction both|outgoing|incoming] [--json]
+ * Find neighbors of a node with optional multi-hop traversal
+ */
+export declare const graphNeighbors: (pos: string[], flags: Flags) => Effect.Effect<void, import("@jamesaphoenix/tx-core").DatabaseError, EdgeService>;
+//# sourceMappingURL=graph.d.ts.map