@principal-ai/principal-studio-cli 0.37.0 → 0.38.0

package/README.md

@@ -20,7 +20,7 @@ Bin name: `principal-ai`.
 
 | Command | Purpose |
 |---|---|
-| `subsystem-model` | Create / open / list / get subsystem models |
+| `subsystem-model` | Create / open / list / get / audit / propose / accept / reject |
 | `open-studio` | Launch or focus Subsystems Studio |
 | `trail` | File City trails |
 | `tour` | Introduction tours |

package/dist/commands/subsystem-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subsystem-model.d.ts","sourceRoot":"","sources":["../../src/commands/subsystem-model.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4QpC,wBAAgB,2BAA2B,IAAI,OAAO,CAwCrD"}
+{"version":3,"file":"subsystem-model.d.ts","sourceRoot":"","sources":["../../src/commands/subsystem-model.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqXpC,wBAAgB,2BAA2B,IAAI,OAAO,CAsFrD"}

package/dist/commands/subsystem-model.js

@@ -152,8 +152,8 @@ async function createAction(options) {
             title: body['title'],
             description: typeof body['description'] === 'string' ? body['description'] : undefined,
             components: body['components'],
-            edges: body['edges'],
-            throughlines: Array.isArray(body['throughlines']) ? body['throughlines'] : undefined,
+            relations: body['relations'],
+            walkthroughs: Array.isArray(body['walkthroughs']) ? body['walkthroughs'] : undefined,
             source: typeof body['source'] === 'string' ? body['source'] : undefined,
             repo: body['repo'],
             repoRoot: typeof body['repoRoot'] === 'string' ? body['repoRoot'] : undefined,
@@ -221,8 +221,85 @@ async function getAction(id) {
     }
     process.stdout.write(JSON.stringify({ ok: true, graph }, null, 2) + '\n');
 }
+async function studioFetch(path, init) {
+    if (!(await studioHttpUp())) {
+        process.stderr.write('Principal Studio HTTP is not running (need audit / propose apply via Studio on :3045).\n');
+        process.exit(2);
+    }
+    try {
+        const res = await fetch(`${studioHttpBase()}${path}`, {
+            ...init,
+            signal: AbortSignal.timeout(120_000),
+            headers: {
+                'Content-Type': 'application/json',
+                ...(init?.headers ?? {}),
+            },
+        });
+        const json = (await res.json());
+        return { ok: res.ok && json.ok !== false, status: res.status, json };
+    }
+    catch (err) {
+        process.stderr.write(`Studio request failed: ${err.message}\n`);
+        process.exit(2);
+    }
+}
+async function auditAction(id) {
+    if (!id) {
+        process.stderr.write('Pass a model id.\n');
+        process.exit(2);
+    }
+    const { ok, json } = await studioFetch(`/api/subsystem-model/${encodeURIComponent(id)}/audit`);
+    process.stdout.write(JSON.stringify(json, null, 2) + '\n');
+    if (!ok)
+        process.exit(2);
+}
+async function proposalsListAction(id, opts) {
+    if (!id) {
+        process.stderr.write('Pass a model id.\n');
+        process.exit(2);
+    }
+    const q = opts.includeResolved ? '?includeResolved=1' : '';
+    const { ok, json } = await studioFetch(`/api/subsystem-model/${encodeURIComponent(id)}/proposals${q}`);
+    process.stdout.write(JSON.stringify(json, null, 2) + '\n');
+    if (!ok)
+        process.exit(2);
+}
+async function proposeAction(id, opts) {
+    if (!id) {
+        process.stderr.write('Pass a model id.\n');
+        process.exit(2);
+    }
+    const payload = (await readPayload(opts.file));
+    if (opts.author && typeof payload['author'] !== 'string') {
+        payload['author'] = opts.author;
+    }
+    const { ok, json } = await studioFetch(`/api/subsystem-model/${encodeURIComponent(id)}/proposals`, { method: 'POST', body: JSON.stringify(payload) });
+    process.stdout.write(JSON.stringify(json, null, 2) + '\n');
+    if (!ok)
+        process.exit(2);
+}
+async function acceptAction(id, proposalId) {
+    if (!id || !proposalId) {
+        process.stderr.write('Pass a model id and proposal id.\n');
+        process.exit(2);
+    }
+    const { ok, json } = await studioFetch(`/api/subsystem-model/${encodeURIComponent(id)}/proposals/${encodeURIComponent(proposalId)}/accept`, { method: 'POST', body: '{}' });
+    process.stdout.write(JSON.stringify(json, null, 2) + '\n');
+    if (!ok)
+        process.exit(2);
+}
+async function rejectAction(id, proposalId) {
+    if (!id || !proposalId) {
+        process.stderr.write('Pass a model id and proposal id.\n');
+        process.exit(2);
+    }
+    const { ok, json } = await studioFetch(`/api/subsystem-model/${encodeURIComponent(id)}/proposals/${encodeURIComponent(proposalId)}/reject`, { method: 'POST', body: '{}' });
+    process.stdout.write(JSON.stringify(json, null, 2) + '\n');
+    if (!ok)
+        process.exit(2);
+}
 export function createSubsystemModelCommand() {
-    const cmd = new Command('subsystem-model').description('Create, open, and list subsystem models (works without Studio already running)');
+    const cmd = new Command('subsystem-model').description('Create, open, audit, and propose corrections for subsystem models');
     cmd
         .command('create')
         .description('Validate + persist a subsystem model JSON, then open it in Principal Studio')
@@ -245,5 +322,35 @@ export function createSubsystemModelCommand() {
         .description('Print a stored subsystem model as JSON')
         .argument('[id]', 'Model id (sg-…)')
         .action(getAction);
+    cmd
+        .command('audit')
+        .description('Run the deterministic dry-run audit (requires Principal Studio HTTP)')
+        .argument('<id>', 'Model id (sg-…)')
+        .action(auditAction);
+    cmd
+        .command('proposals')
+        .description('List correction proposals for a model (requires Studio HTTP)')
+        .argument('<id>', 'Model id (sg-…)')
+        .option('--include-resolved', 'Include accepted/rejected proposals')
+        .action((id, opts) => proposalsListAction(id, opts));
+    cmd
+        .command('propose')
+        .description('Submit a correction proposal with rationale (does not apply unless auto-accept is on)')
+        .argument('<id>', 'Model id (sg-…)')
+        .option('-f, --file <path>', 'Proposal JSON: { rationale, changes[], finding?, author? } (default: stdin)')
+        .option('--author <name>', 'Author tag (e.g. agent name)')
+        .action((id, opts) => proposeAction(id, opts));
+    cmd
+        .command('accept')
+        .description('Accept a pending proposal and apply it to the model')
+        .argument('<id>', 'Model id (sg-…)')
+        .argument('<proposalId>', 'Proposal id (sp-…)')
+        .action(acceptAction);
+    cmd
+        .command('reject')
+        .description('Reject a pending proposal without changing the model')
+        .argument('<id>', 'Model id (sg-…)')
+        .argument('<proposalId>', 'Proposal id (sp-…)')
+        .action(rejectAction);
     return cmd;
 }