@ontologie/cli 0.1.0-preview.1

package/dist/commands/index.js

@@ -0,0 +1,345 @@
+/**
+ * Canonical CLI commands registry — single source of truth.
+ *
+ * Every command registered on the `dataforge` Commander program lives in this
+ * array. Consumers:
+ *   - `sdk/packages/cli/src/cli.ts` iterates this list to call `registerFn`.
+ *   - `tests/structural/sdk-cli-parity.test.ts` ratchet diffs this list
+ *     against the tests in `sdk/tests/verify/` and the contract docs
+ *     (`CLI-CONFORM-01`). The SDK-path ↔ backend-mount diff
+ *     (`SDK-PARITY-02`) is `it.todo()` until AST or runtime probe lands —
+ *     see #990 / #992 review notes.
+ *   - Future doc generators / shell completions read it instead of duplicating
+ *     the command list.
+ *
+ * Stability tiers map to `sdk/docs/SDK-PUBLIC-STRATEGY.md`:
+ *   - `stable`   — committed surface, SemVer + 12-month deprecation window
+ *   - `preview`  — best-effort, may change in minor versions
+ *   - `internal` — hidden from `--help`, not part of the public contract
+ *
+ * **Rule** (no double SOT): if a command is added or removed, this array is the
+ * authoritative location. Do not register commands directly in `cli.ts`.
+ */
+import { registerCache } from './cache.js';
+import { registerCheck } from './check.js';
+import { registerConfig } from './config.js';
+import { registerContext } from './context.js';
+import { registerDocsAlias } from './docs-alias.js';
+import { registerDoctor } from './doctor.js';
+import { registerDev } from './dev.js';
+import { registerGenerate } from './generate.js';
+import { registerGraph } from './graph.js';
+import { registerInit } from './init.js';
+import { registerKnowledge } from './knowledge.js';
+import { registerNodes } from './nodes.js';
+import { registerOpenapi } from './openapi.js';
+import { registerProcess } from './process.js';
+import { registerSchema } from './schema.js';
+import { registerWhoami } from './whoami.js';
+import { registerAudit } from './audit.js';
+import { registerActions } from './actions.js';
+import { registerPlan } from './plan.js';
+import { registerCapabilities } from './capabilities.js';
+import { registerQuery } from './query.js';
+import { registerInstances } from './instances.js';
+import { registerImport } from './import.js';
+import { registerUsage } from './usage.js';
+import { registerKeys } from './keys.js';
+import { registerSearch } from './search.js';
+import { registerAgent } from './agent.js';
+import { registerModel } from './model.js';
+// ---------------------------------------------------------------------------
+// Canonical registry
+// ---------------------------------------------------------------------------
+/**
+ * Every command registered on the `dataforge` program. Counts are pinned in
+ * `tests/structural/sdk-cli-parity.test.ts` (`CLI-CONFORM-01`) so any
+ * add/remove/tier-change forces an intentional update on both sides.
+ * Order matches the original `cli.ts` to preserve `--help` output stability.
+ */
+export const CANONICAL_CLI_COMMANDS = [
+    // -- ontology context (from original ontologie CLI) --
+    {
+        name: 'whoami',
+        subcommands: [],
+        source: './whoami',
+        stability: 'stable',
+        description: 'Show connection info, identity, and health',
+        registerFn: registerWhoami,
+    },
+    {
+        name: 'nodes',
+        subcommands: ['list', 'get', 'search'],
+        source: './nodes',
+        stability: 'stable',
+        description: 'Browse and search ontology nodes',
+        registerFn: registerNodes,
+    },
+    {
+        name: 'knowledge',
+        subcommands: ['search', 'get', 'list'],
+        source: './knowledge',
+        stability: 'stable',
+        description: 'Knowledge base search and retrieval',
+        registerFn: registerKnowledge,
+    },
+    {
+        name: 'graph',
+        subcommands: ['traverse', 'neighbors', 'path'],
+        source: './graph',
+        stability: 'stable',
+        description: 'Graph traversal and shortest-path queries',
+        registerFn: registerGraph,
+    },
+    {
+        name: 'schema',
+        subcommands: ['export', 'describe', 'search', 'diff', 'push', 'pull', 'check'],
+        source: './schema',
+        stability: 'stable',
+        description: 'Ontology schema authoring, diff, and drift check',
+        registerFn: registerSchema,
+    },
+    {
+        name: 'context',
+        subcommands: ['pack'],
+        source: './context',
+        stability: 'stable',
+        description: 'LLM-ready context assembly',
+        registerFn: registerContext,
+    },
+    {
+        name: 'process',
+        subcommands: ['lint', 'test'],
+        source: './process',
+        stability: 'preview',
+        description: 'Model assurance linting and deterministic process tests',
+        registerFn: registerProcess,
+    },
+    {
+        name: 'cache',
+        subcommands: ['clear', 'stats'],
+        source: './cache',
+        stability: 'internal',
+        description: 'Local cache inspection and clearing',
+        registerFn: registerCache,
+        registerOptions: { hidden: true },
+    },
+    {
+        name: 'config',
+        subcommands: [
+            'set',
+            'get',
+            'list',
+            'migrate',
+        ],
+        source: './config',
+        stability: 'stable',
+        description: 'Manage local CLI configuration profiles',
+        registerFn: registerConfig,
+    },
+    {
+        name: 'doctor',
+        subcommands: [],
+        source: './doctor',
+        stability: 'stable',
+        description: 'Diagnostics for environment, credentials, and connectivity',
+        registerFn: registerDoctor,
+    },
+    // -- SDK generator commands (from @dataforge/sdk-generator, unified in 3.4.0) --
+    {
+        name: 'generate',
+        subcommands: [],
+        source: './generate',
+        stability: 'stable',
+        description: 'Generate typed SDK code from the remote ontology manifest',
+        registerFn: registerGenerate,
+    },
+    {
+        name: 'check',
+        subcommands: [],
+        source: './check',
+        stability: 'stable',
+        description: 'Verify generated code is in sync with remote (drift gate)',
+        registerFn: registerCheck,
+    },
+    {
+        name: 'openapi',
+        subcommands: [],
+        source: './openapi',
+        stability: 'preview',
+        description: 'Emit an OpenAPI 3 document for the remote ontology',
+        registerFn: registerOpenapi,
+    },
+    {
+        name: 'init',
+        subcommands: [],
+        source: './init',
+        stability: 'stable',
+        description: 'Scaffold a new dataforge project',
+        registerFn: registerInit,
+    },
+    // -- audit (preview) --
+    {
+        name: 'audit',
+        subcommands: ['list', 'export', 'history'],
+        source: './audit',
+        stability: 'preview',
+        description: 'Query and export audit events',
+        registerFn: registerAudit,
+    },
+    // -- actions + plan (stable V1 — ROADMAP §24) --
+    {
+        name: 'actions',
+        subcommands: ['list', 'describe', 'run'],
+        source: './actions',
+        stability: 'stable',
+        description: 'List, describe, and execute ontology actions',
+        registerFn: registerActions,
+    },
+    {
+        name: 'plan',
+        subcommands: [
+            'list',
+            'inspect',
+            'verify',
+            'proof',
+            'revoke',
+            'handoff',
+            'handoff-status',
+            'route',
+            'route-status',
+            'export',
+        ],
+        source: './plan',
+        stability: 'stable',
+        description: 'Plan artifact operations (inspect, verify, revoke, list)',
+        registerFn: registerPlan,
+    },
+    {
+        name: 'dev',
+        subcommands: [],
+        source: './dev',
+        stability: 'stable',
+        description: 'Start a local DataForge mock API server',
+        registerFn: registerDev,
+    },
+    {
+        name: 'capabilities',
+        subcommands: ['export', 'diff', 'validate'],
+        source: './capabilities',
+        stability: 'stable',
+        description: 'Capabilities manifest export and validation',
+        registerFn: registerCapabilities,
+    },
+    {
+        name: 'model',
+        subcommands: ['change-plan'],
+        source: './model',
+        stability: 'preview',
+        description: 'Model assurance change planning',
+        registerFn: registerModel,
+    },
+    // -- V1 external developer commands --
+    {
+        name: 'query',
+        subcommands: [],
+        source: './query',
+        stability: 'stable',
+        description: 'Query ObjectSet instances by type',
+        registerFn: registerQuery,
+    },
+    {
+        name: 'instance',
+        subcommands: ['list', 'get', 'create', 'update', 'delete'],
+        source: './instances',
+        stability: 'stable',
+        description: 'Object instance operations (Digital Twin)',
+        registerFn: registerInstances,
+    },
+    {
+        name: 'import',
+        subcommands: [],
+        source: './import',
+        stability: 'stable',
+        description: 'Import data from CSV/JSON/JSONL into ObjectType instances',
+        registerFn: registerImport,
+    },
+    {
+        name: 'usage',
+        subcommands: ['me', 'forecast'],
+        source: './usage',
+        stability: 'stable',
+        description: 'Usage and quota operations',
+        registerFn: registerUsage,
+    },
+    {
+        name: 'keys',
+        subcommands: ['list', 'create', 'revoke'],
+        source: './keys',
+        stability: 'stable',
+        description: 'API key management',
+        registerFn: registerKeys,
+    },
+    {
+        name: 'search',
+        subcommands: [],
+        source: './search',
+        stability: 'stable',
+        description: 'Search entities across the ontology',
+        registerFn: registerSearch,
+    },
+    // -- agent-ready workspace (ROADMAP §26) --
+    {
+        name: 'agent',
+        subcommands: ['init', 'doctor'],
+        source: './agent',
+        stability: 'stable',
+        description: 'Agent configuration: generate agent files and verify readiness',
+        registerFn: registerAgent,
+    },
+    // -- legacy / hidden aliases --
+    {
+        name: 'docs',
+        subcommands: ['search'],
+        source: './docs-alias',
+        stability: 'internal',
+        description: 'Deprecated alias — use `knowledge` instead',
+        registerFn: registerDocsAlias,
+        registerOptions: { hidden: true },
+    },
+];
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Returns the immutable registry of canonical CLI commands.
+ *
+ * Exposed as a function (rather than re-exporting the `const`) so callers can
+ * mock it in tests or wrap it with extra logic without circular imports.
+ */
+export function getCanonicalCliCommands() {
+    return CANONICAL_CLI_COMMANDS;
+}
+/**
+ * Convenience helper used by `cli.ts` to wire every command in one pass.
+ * Honors `registerOptions` so commands like `cache` keep their `hidden:true`.
+ *
+ * `program` is intentionally typed as `any` — Commander ships two
+ * incompatible-looking exports (`Command` and `CommanderStatic.Command`) that
+ * TypeScript narrows differently depending on the call site, causing a
+ * spurious mismatch. The runtime is unaffected.
+ */
+export function registerAllCommands(program) {
+    if (!program._storeOptionsAsPropertiesCalled) {
+        program.storeOptionsAsProperties(false);
+    }
+    for (const cmd of CANONICAL_CLI_COMMANDS) {
+        if (cmd.registerOptions) {
+            cmd.registerFn(program, cmd.registerOptions);
+        }
+        else {
+            cmd.registerFn(program);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,7 @@
+/**
+ * dataforge init — scaffold a new DataForge project
+ * @since 3.4.0
+ */
+import type { Command } from 'commander';
+export declare function registerInit(program: Command): void;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgGnD"}

package/dist/commands/init.js

@@ -0,0 +1,101 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { TEMPLATES } from '../templates/index.js';
+import { getExitCode } from '../output/errors.js';
+import { writeAgentFiles } from './agent-files.js';
+import { runSyncDoctorChecks } from './agent.js';
+export function registerInit(program) {
+    program
+        .command('init [directory]')
+        .description('Scaffold a new DataForge project')
+        .option('--template <name>', `Project template: ${Object.keys(TEMPLATES).join(' | ')}`, 'basic')
+        .option('--target <agent>', 'Agent target: codex | claude | all (generates AGENTS.md / CLAUDE.md)')
+        .option('--agent-ready', 'Generate full agent configuration (AGENTS.md, CLAUDE.md, skills, .codex)')
+        .option('--force', 'Overwrite existing files', false)
+        .action((directory, opts) => {
+        const template = TEMPLATES[opts.template];
+        if (!template) {
+            console.error(`Unknown template: ${opts.template}. Available: ${Object.keys(TEMPLATES).join(', ')}`);
+            // INVALID_USAGE (exit 2) — user passed a bad --template option.
+            // Exit value changes from 1 → 2 vs pre-refactor; semantic gain for
+            // agents reading exit codes (server-failure vs bad-arg distinction).
+            process.exit(getExitCode('INVALID_USAGE'));
+        }
+        const targetDir = path.resolve(directory ?? '.');
+        fs.mkdirSync(targetDir, { recursive: true });
+        // Write template files
+        for (const [filePath, content] of Object.entries(template.files)) {
+            const fullPath = path.join(targetDir, filePath);
+            const dir = path.dirname(fullPath);
+            fs.mkdirSync(dir, { recursive: true });
+            if (fs.existsSync(fullPath) && !opts.force) {
+                console.log(`  skip ${filePath} (exists)`);
+                continue;
+            }
+            fs.writeFileSync(fullPath, content, 'utf-8');
+            console.log(`  create ${filePath}`);
+        }
+        // Generate agent files
+        if (opts.agentReady) {
+            // --agent-ready: full agent file set
+            const results = writeAgentFiles(targetDir, 'all', { force: opts.force });
+            for (const r of results) {
+                console.log(`  ${r.created ? 'create' : 'skip  '} ${r.path}${r.skipped ? ' (exists)' : ''}`);
+            }
+            // Create empty directories for agent workflow
+            const emptyDirs = ['dataforge.generated', '.dataforge/examples', '.dataforge/plans', '.dataforge/evals'];
+            for (const dir of emptyDirs) {
+                const fullPath = path.join(targetDir, dir);
+                if (!fs.existsSync(fullPath)) {
+                    fs.mkdirSync(fullPath, { recursive: true });
+                    console.log(`  create ${dir}/`);
+                }
+            }
+        }
+        else if (opts.target) {
+            // Legacy --target flag: limited agent docs
+            const target = opts.target === 'all' ? 'all'
+                : opts.target === 'codex' ? 'codex'
+                    : 'claude';
+            const results = writeAgentFiles(targetDir, target, { force: opts.force });
+            for (const r of results) {
+                console.log(`  ${r.created ? 'create' : 'skip  '} ${r.path}${r.skipped ? ' (exists)' : ''}`);
+            }
+        }
+        console.log(`\nProject scaffolded in ${path.relative(process.cwd(), targetDir) || '.'}`);
+        console.log('\nNext steps:');
+        console.log('  1. cp .env.example .env && edit .env');
+        console.log('  2. npm install');
+        console.log('  3. Edit dataforge.schema.ts to define your ontology');
+        console.log('  4. dataforge schema push --yes');
+        if (template.hasSeed) {
+            console.log('  5. dataforge import --file dataforge.seed.jsonl --format jsonl');
+            console.log('  6. npm start');
+        }
+        else {
+            console.log('  5. npm start');
+        }
+        if (opts.agentReady) {
+            console.log('\nAgent doctor:');
+            try {
+                const checks = runSyncDoctorChecks(targetDir);
+                for (const c of checks) {
+                    const icon = c.status === 'ok' ? 'OK' : c.status === 'warn' ? 'WARN' : 'ERROR';
+                    console.log(`  [${icon}] ${c.name}: ${c.message}`);
+                    if (c.detail)
+                        console.log(`        ${c.detail}`);
+                }
+                const errors = checks.filter(c => c.status === 'error').length;
+                const warns = checks.filter(c => c.status === 'warn').length;
+                console.log(`\n  ${checks.length} checks: ${checks.length - errors - warns} ok, ${warns} warnings, ${errors} errors`);
+                if (errors > 0) {
+                    console.log('  Full check: dataforge agent doctor --format json');
+                }
+            }
+            catch {
+                console.log('  dataforge agent doctor --format json');
+            }
+        }
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/instances.d.ts

@@ -0,0 +1,7 @@
+/**
+ * ontologie instance -- list, get, create, update, delete object instances
+ */
+import { Command } from 'commander';
+export declare function rethrowMutationError(err: unknown): never;
+export declare function registerInstances(program: Command): void;
+//# sourceMappingURL=instances.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../src/commands/instances.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAmBxD;AAMD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqbxD"}