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

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

@@ -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;
 }

package/dist/index.cjs

@@ -3457,7 +3457,7 @@ var require_subsystem_model = __commonJS({
   "node_modules/@principal-ai/subsystems-core/dist/types/subsystem-model.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.isSubsystemModelDocument = void 0;
+    exports2.toPortableDocument = exports2.isSubsystemModelDocument = void 0;
     function isSubsystemModelDocument(value) {
       if (!value || typeof value !== "object")
         return false;
@@ -3465,6 +3465,46 @@ var require_subsystem_model = __commonJS({
       return typeof v.title === "string" && Array.isArray(v.components) && Array.isArray(v.edges);
     }
     exports2.isSubsystemModelDocument = isSubsystemModelDocument;
+    function toPortableDocument(doc) {
+      const out = {
+        title: doc.title,
+        components: doc.components,
+        edges: doc.edges
+      };
+      if (doc.$schema)
+        out.$schema = doc.$schema;
+      if (doc.description)
+        out.description = doc.description;
+      if (doc.throughlines)
+        out.throughlines = doc.throughlines;
+      return out;
+    }
+    exports2.toPortableDocument = toPortableDocument;
+  }
+});
+
+// node_modules/@principal-ai/subsystems-core/dist/types/index.js
+var require_types = __commonJS({
+  "node_modules/@principal-ai/subsystems-core/dist/types/index.js"(exports2) {
+    "use strict";
+    var __createBinding = exports2 && exports2.__createBinding || (Object.create ? function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = { enumerable: true, get: function() {
+          return m[k];
+        } };
+      }
+      Object.defineProperty(o, k2, desc);
+    } : function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      o[k2] = m[k];
+    });
+    var __exportStar = exports2 && exports2.__exportStar || function(m, exports3) {
+      for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports3, p)) __createBinding(exports3, m, p);
+    };
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    __exportStar(require_subsystem_model(), exports2);
   }
 });
 
@@ -9671,12 +9711,25 @@ var require_fixture = __commonJS({
 var require_node = __commonJS({
   "node_modules/@principal-ai/subsystems-core/dist/node.js"(exports2) {
     "use strict";
+    var __createBinding = exports2 && exports2.__createBinding || (Object.create ? function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = { enumerable: true, get: function() {
+          return m[k];
+        } };
+      }
+      Object.defineProperty(o, k2, desc);
+    } : function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      o[k2] = m[k];
+    });
+    var __exportStar = exports2 && exports2.__exportStar || function(m, exports3) {
+      for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports3, p)) __createBinding(exports3, m, p);
+    };
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.opencodeRowsToUniversalEvents = exports2.collectRepositories = exports2.accumulateEvents = exports2.normalizeEventsWithAdapter = exports2.normalizeEvents = exports2.NodePathNormalizationAdapter = exports2.buildAgentSessionFixture = exports2.fetchRawEvents = exports2.detectAgent = exports2.listAgentSessions = exports2.defaultOpenCodeDBPath = exports2.OpenCodeEventStore = exports2.publishedFromDraft = exports2.LEGACY_TOPICS_BLOB = exports2.TOPICS_DIR = exports2.PRINCIPAL_DIR = exports2.TopicStore = exports2.isSubsystemModelDocument = void 0;
-    var subsystem_model_1 = require_subsystem_model();
-    Object.defineProperty(exports2, "isSubsystemModelDocument", { enumerable: true, get: function() {
-      return subsystem_model_1.isSubsystemModelDocument;
-    } });
+    exports2.opencodeRowsToUniversalEvents = exports2.collectRepositories = exports2.accumulateEvents = exports2.normalizeEventsWithAdapter = exports2.normalizeEvents = exports2.NodePathNormalizationAdapter = exports2.buildAgentSessionFixture = exports2.fetchRawEvents = exports2.detectAgent = exports2.listAgentSessions = exports2.defaultOpenCodeDBPath = exports2.OpenCodeEventStore = exports2.publishedFromDraft = exports2.LEGACY_TOPICS_BLOB = exports2.TOPICS_DIR = exports2.PRINCIPAL_DIR = exports2.TopicStore = void 0;
+    __exportStar(require_types(), exports2);
     var topicStore_1 = require_topicStore();
     Object.defineProperty(exports2, "TopicStore", { enumerable: true, get: function() {
       return topicStore_1.TopicStore;
@@ -15357,7 +15410,8 @@ var SUBSYSTEM_COMPONENT_CONSTRUCTS = [
   "type_alias",
   "enum",
   "store",
-  "external"
+  "external",
+  "custom_entity"
 ];
 var SUBSYSTEM_DETAIL_PROVENANCES = ["verified", "authored"];
 function graphId() {
@@ -15478,7 +15532,8 @@ function normalizeDetailProvenance(components) {
       method: ["parameters"],
       class: ["methods", "properties", "extends", "implements", "instantiations", "references"],
       type: ["properties", "usedBy", "implementors"],
-      module: ["imports", "exports", "symbols"]
+      module: ["imports", "exports", "symbols"],
+      custom_entity: ["attributes"]
     };
     for (const key of arrays[String(kind)] ?? []) {
       if (!Array.isArray(detail[key])) detail[key] = [];
@@ -15520,7 +15575,8 @@ function indexEntryFor(record) {
     lastOpenedAt: record.lastOpenedAt,
     fileName: `${record.id}.json`,
     source: record.source,
-    repo: record.repo
+    repo: record.repo,
+    gist: record.gist
   };
 }
 async function readIndex() {
@@ -15809,9 +15865,94 @@ 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(12e4),
+      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}
+`);
+    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 readPayload2(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);
+}
 function createSubsystemModelCommand() {
   const cmd = new Command("subsystem-model").description(
-    "Create, open, and list subsystem models (works without Studio already running)"
+    "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"
@@ -15825,11 +15966,27 @@ function createSubsystemModelCommand() {
   ).action(openAction);
   cmd.command("list").description("List stored subsystem models").action(listAction);
   cmd.command("get").description("Print a stored subsystem model as JSON").argument("[id]", "Model id (sg-\u2026)").action(getAction);
+  cmd.command("audit").description(
+    "Run the deterministic dry-run audit (requires Principal Studio HTTP)"
+  ).argument("<id>", "Model id (sg-\u2026)").action(auditAction);
+  cmd.command("proposals").description("List correction proposals for a model (requires Studio HTTP)").argument("<id>", "Model id (sg-\u2026)").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-\u2026)").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-\u2026)").argument("<proposalId>", "Proposal id (sp-\u2026)").action(acceptAction);
+  cmd.command("reject").description("Reject a pending proposal without changing the model").argument("<id>", "Model id (sg-\u2026)").argument("<proposalId>", "Proposal id (sp-\u2026)").action(rejectAction);
   return cmd;
 }
 
 // src/index.ts
-var VERSION = true ? "0.37.0" : "0.0.0-dev";
+var VERSION = true ? "0.37.1" : "0.0.0-dev";
 var program2 = new Command();
 program2.name("principal-ai").description(
   "Principal AI CLI \u2014 subsystem models, Subsystems Studio, trails, and agent sessions"