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

package/dist/index.cjs

@@ -3457,14 +3457,88 @@ 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.deriveGraphEdges = exports2.derivedGraphEdgeId = exports2.toPortableDocument = exports2.isSubsystemModelDocument = void 0;
     function isSubsystemModelDocument(value) {
       if (!value || typeof value !== "object")
         return false;
       const v = value;
-      return typeof v.title === "string" && Array.isArray(v.components) && Array.isArray(v.edges);
+      return typeof v.title === "string" && Array.isArray(v.components) && Array.isArray(v.relations);
     }
     exports2.isSubsystemModelDocument = isSubsystemModelDocument;
+    function toPortableDocument(doc) {
+      const out = {
+        title: doc.title,
+        components: doc.components,
+        relations: doc.relations
+      };
+      if (doc.$schema)
+        out.$schema = doc.$schema;
+      if (doc.description)
+        out.description = doc.description;
+      if (doc.walkthroughs)
+        out.walkthroughs = doc.walkthroughs;
+      return out;
+    }
+    exports2.toPortableDocument = toPortableDocument;
+    function derivedGraphEdgeId(from, to, mechanism) {
+      return `${from}--${mechanism}-->${to}`;
+    }
+    exports2.derivedGraphEdgeId = derivedGraphEdgeId;
+    function deriveGraphEdges2(doc) {
+      const byId = /* @__PURE__ */ new Map();
+      for (const r of doc.relations ?? []) {
+        const id = r.id || derivedGraphEdgeId(r.from, r.to, r.relationType);
+        if (!byId.has(id)) {
+          byId.set(id, {
+            id,
+            from: r.from,
+            to: r.to,
+            mechanism: r.relationType,
+            refs: r.refs
+          });
+        }
+      }
+      for (const w of doc.walkthroughs ?? []) {
+        for (const step of w.steps) {
+          const id = derivedGraphEdgeId(step.from, step.to, step.mechanism);
+          if (!byId.has(id)) {
+            byId.set(id, {
+              id,
+              from: step.from,
+              to: step.to,
+              mechanism: step.mechanism
+            });
+          }
+        }
+      }
+      return [...byId.values()];
+    }
+    exports2.deriveGraphEdges = deriveGraphEdges2;
+  }
+});
+
+// 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 +9745,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;
@@ -9737,6 +9824,31 @@ var require_node = __commonJS({
   }
 });
 
+// node_modules/@principal-ai/subsystems-core/dist/index.js
+var require_dist2 = __commonJS({
+  "node_modules/@principal-ai/subsystems-core/dist/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_types(), exports2);
+  }
+});
+
 // node_modules/commander/esm.mjs
 var import_index = __toESM(require_commander(), 1);
 var {
@@ -15326,29 +15438,9 @@ var import_node_fs7 = require("node:fs");
 var import_node_fs6 = require("node:fs");
 var import_node_os6 = require("node:os");
 var import_node_path5 = require("node:path");
+var import_subsystems_core = __toESM(require_dist2(), 1);
 var ROOT3 = (0, import_node_path5.join)((0, import_node_os6.homedir)(), ".principal", "subsystem-models");
 var INDEX_PATH = (0, import_node_path5.join)(ROOT3, "_index.json");
-var SUBSYSTEM_EDGE_MECHANISMS = [
-  "imports",
-  "imports_from",
-  "re_exports",
-  "defines",
-  "calls",
-  "extends",
-  "inherits",
-  "implements",
-  "mixes_in",
-  "uses",
-  "method",
-  "references",
-  "contains",
-  "feeds",
-  "produces",
-  "writes",
-  "reads",
-  "watches",
-  "registers-into"
-];
 var SUBSYSTEM_COMPONENT_CONSTRUCTS = [
   "class",
   "function",
@@ -15357,9 +15449,10 @@ var SUBSYSTEM_COMPONENT_CONSTRUCTS = [
   "type_alias",
   "enum",
   "store",
-  "external"
+  "external",
+  "custom_entity"
 ];
-var SUBSYSTEM_DETAIL_PROVENANCES = ["verified", "authored"];
+var SUBSYSTEM_DECLARATION_PROVENANCES = ["verified", "authored"];
 function graphId() {
   const ts = Date.now();
   const rand = Math.random().toString(36).slice(2, 11);
@@ -15374,56 +15467,84 @@ function subsystemModelFilePath(id) {
 async function ensureDir() {
   await import_node_fs6.promises.mkdir(ROOT3, { recursive: true });
 }
-function findEdgeMechanismProblems(edges) {
-  if (!Array.isArray(edges)) return [];
+var SUBSYSTEM_RELATION_TYPES = [
+  "imports",
+  "imports_from",
+  "re_exports",
+  "defines",
+  "extends",
+  "inherits",
+  "implements",
+  "mixes_in",
+  "method",
+  "references",
+  "contains"
+];
+var SUBSYSTEM_WALKTHROUGH_MECHANISMS = [
+  "calls",
+  "uses",
+  "feeds",
+  "produces",
+  "writes",
+  "reads",
+  "watches",
+  "registers-into"
+];
+function findRelationTypeProblems(relations) {
+  if (!Array.isArray(relations)) return ["relations must be an array"];
   const problems = [];
-  for (const edge of edges) {
-    const e = edge;
-    if (typeof e?.mechanism === "string" && SUBSYSTEM_EDGE_MECHANISMS.includes(e.mechanism)) {
-      continue;
+  for (const rel of relations) {
+    const r = rel;
+    if (typeof r?.id !== "string" || !r.id.trim()) {
+      problems.push(`relation ${JSON.stringify(r?.id ?? "<no id>")}: id is required`);
+    }
+    if (typeof r?.from !== "string" || !r.from.trim()) {
+      problems.push(`relation ${JSON.stringify(r?.id ?? "<no id>")}: from is required`);
+    }
+    if (typeof r?.to !== "string" || !r.to.trim()) {
+      problems.push(`relation ${JSON.stringify(r?.id ?? "<no id>")}: to is required`);
+    }
+    if (typeof r?.relationType !== "string" || !SUBSYSTEM_RELATION_TYPES.includes(r.relationType)) {
+      problems.push(
+        `relation ${JSON.stringify(r?.id ?? "<no id>")}: unknown relationType ${JSON.stringify(r?.relationType)}`
+      );
     }
-    problems.push(
-      `edge ${JSON.stringify(e?.id ?? "<no id>")}: unknown mechanism ${JSON.stringify(e?.mechanism)} \u2014 allowed: ${SUBSYSTEM_EDGE_MECHANISMS.join(", ")}`
-    );
   }
   return problems;
 }
-function findThroughlineProblems(edges, throughlines) {
-  if (throughlines === void 0) return [];
-  if (!Array.isArray(throughlines)) return ["throughlines must be an array"];
-  const edgeIds = new Set(
-    (Array.isArray(edges) ? edges : []).map((e) => e?.id).filter((id) => typeof id === "string")
-  );
+function findWalkthroughProblems(walkthroughs) {
+  if (walkthroughs === void 0) return [];
+  if (!Array.isArray(walkthroughs)) return ["walkthroughs must be an array"];
   const problems = [];
-  for (const tl of throughlines) {
-    const t = tl;
-    const label = JSON.stringify(t?.id ?? "<no id>");
-    if (typeof t?.id !== "string" || !t.id.trim()) {
-      problems.push(`throughline ${label}: id is required`);
+  for (const wt of walkthroughs) {
+    const w = wt;
+    const label = JSON.stringify(w?.id ?? "<no id>");
+    if (typeof w?.id !== "string" || !w.id.trim()) {
+      problems.push(`walkthrough ${label}: id is required`);
       continue;
     }
-    if (typeof t?.title !== "string" || !t.title.trim()) {
-      problems.push(`throughline ${label}: title is required`);
+    if (typeof w?.title !== "string" || !w.title.trim()) {
+      problems.push(`walkthrough ${label}: title is required`);
     }
-    if (!Array.isArray(t.steps)) {
-      problems.push(`throughline ${label}: steps array is required`);
+    if (!Array.isArray(w.steps)) {
+      problems.push(`walkthrough ${label}: steps array is required`);
       continue;
     }
-    t.steps.forEach((step, i) => {
+    w.steps.forEach((step, i) => {
       const s = step;
-      if (typeof s?.edgeId !== "string" || !edgeIds.has(s.edgeId)) {
-        problems.push(
-          `throughline ${label}: step ${i} edgeId ${JSON.stringify(s?.edgeId ?? "<missing>")} does not match any edge in the graph`
-        );
+      if (typeof s?.from !== "string" || !s.from.trim()) {
+        problems.push(`walkthrough ${label}: step ${i} from is required`);
+      }
+      if (typeof s?.to !== "string" || !s.to.trim()) {
+        problems.push(`walkthrough ${label}: step ${i} to is required`);
+      }
+      if (typeof s?.mechanism !== "string" || !SUBSYSTEM_WALKTHROUGH_MECHANISMS.includes(s.mechanism)) {
+        problems.push(`walkthrough ${label}: step ${i} unknown mechanism ${JSON.stringify(s?.mechanism)}`);
       }
       if (typeof s?.file !== "string" || !s.file.trim()) {
-        problems.push(
-          `throughline ${label}: step ${i} file is required (edgeId ${JSON.stringify(s?.edgeId ?? "<missing>")})`
-        );
+        problems.push(`walkthrough ${label}: step ${i} file is required`);
       } else if (typeof s?.line !== "number" || !Number.isInteger(s.line) || s.line < 1) {
-        problems.push(
-          `throughline ${label}: step ${i} line must be a positive 1-based integer (edgeId ${JSON.stringify(s?.edgeId ?? "<missing>")}, file ${JSON.stringify(s?.file)})`
-        );
+        problems.push(`walkthrough ${label}: step ${i} line must be a positive 1-based integer`);
       }
     });
   }
@@ -15443,45 +15564,48 @@ function findComponentConstructProblems(components) {
   }
   return problems;
 }
-function findDetailProvenanceProblems(components) {
+function findDeclarationProvenanceProblems(components) {
   if (!Array.isArray(components)) return [];
   const problems = [];
   for (const component of components) {
     const c = component;
-    if (!c || typeof c !== "object" || !c["detail"]) continue;
-    const p = c["detailProvenance"];
+    if (!c || typeof c !== "object") continue;
+    if (!c["declaration"]) continue;
+    const p = c["declarationProvenance"];
     if (p === void 0) continue;
-    if (typeof p === "string" && SUBSYSTEM_DETAIL_PROVENANCES.includes(p)) {
+    if (typeof p === "string" && SUBSYSTEM_DECLARATION_PROVENANCES.includes(p)) {
       continue;
     }
     problems.push(
-      `component ${JSON.stringify(String(c["id"] ?? "<no id>"))}: invalid detailProvenance ${JSON.stringify(p)} \u2014 allowed: ${SUBSYSTEM_DETAIL_PROVENANCES.join(", ")}. Hand-authored details must be "authored"; "verified" is reserved for tool-extracted data.`
+      `component ${JSON.stringify(String(c["id"] ?? "<no id>"))}: invalid declarationProvenance ${JSON.stringify(p)} \u2014 allowed: ${SUBSYSTEM_DECLARATION_PROVENANCES.join(", ")}. Hand-authored declarations must be "authored"; "verified" is reserved for tool-extracted data.`
     );
   }
   return problems;
 }
-function normalizeDetailProvenance(components) {
+function normalizeDeclarationProvenance(components) {
   if (!Array.isArray(components)) return;
   for (const component of components) {
     const c = component;
     if (!c || typeof c !== "object") continue;
-    const detail = c["detail"];
-    if (!detail || typeof detail !== "object") {
-      delete c["detailProvenance"];
+    const declaration = c["declaration"];
+    if (!declaration || typeof declaration !== "object") {
+      delete c["declarationProvenance"];
       continue;
     }
-    const p = c["detailProvenance"];
-    if (p !== "verified" && p !== "authored") c["detailProvenance"] = "authored";
-    const kind = detail["kind"];
+    const p = c["declarationProvenance"];
+    if (p !== "verified" && p !== "authored") c["declarationProvenance"] = "authored";
+    const kind = declaration["kind"];
     const arrays = {
       function: ["parameters", "callers", "callees"],
       method: ["parameters"],
       class: ["methods", "properties", "extends", "implements", "instantiations", "references"],
       type: ["properties", "usedBy", "implementors"],
-      module: ["imports", "exports", "symbols"]
+      module: ["imports", "exports", "symbols"],
+      custom_entity: ["attributes"],
+      store: ["properties"]
     };
     for (const key of arrays[String(kind)] ?? []) {
-      if (!Array.isArray(detail[key])) detail[key] = [];
+      if (!Array.isArray(declaration[key])) declaration[key] = [];
     }
   }
 }
@@ -15497,15 +15621,15 @@ function findCreateProblems(body) {
   if (!Array.isArray(body["components"])) {
     problems.push("components array is required");
   }
-  if (!Array.isArray(body["edges"])) {
-    problems.push("edges array is required");
+  if (!Array.isArray(body["relations"])) {
+    problems.push("relations array is required");
   }
   if (problems.length > 0) return problems;
   return [
     ...findComponentConstructProblems(body["components"]),
-    ...findDetailProvenanceProblems(body["components"]),
-    ...findEdgeMechanismProblems(body["edges"]),
-    ...findThroughlineProblems(body["edges"], body["throughlines"])
+    ...findDeclarationProvenanceProblems(body["components"]),
+    ...findRelationTypeProblems(body["relations"]),
+    ...findWalkthroughProblems(body["walkthroughs"])
   ];
 }
 function indexEntryFor(record) {
@@ -15514,13 +15638,17 @@ function indexEntryFor(record) {
     title: record.title,
     description: record.description,
     componentCount: record.components.length,
-    edgeCount: record.edges.length,
+    edgeCount: (0, import_subsystems_core.deriveGraphEdges)({
+      relations: record.relations,
+      walkthroughs: record.walkthroughs
+    }).length,
     createdAt: record.createdAt,
     updatedAt: record.updatedAt,
     lastOpenedAt: record.lastOpenedAt,
     fileName: `${record.id}.json`,
     source: record.source,
-    repo: record.repo
+    repo: record.repo,
+    gist: record.gist
   };
 }
 async function readIndex() {
@@ -15579,7 +15707,7 @@ async function getSubsystemModel(id) {
 }
 async function createSubsystemModel(doc) {
   await ensureDir();
-  normalizeDetailProvenance(doc.components);
+  normalizeDeclarationProvenance(doc.components);
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const record = {
     ...doc,
@@ -15723,8 +15851,8 @@ async function createAction(options) {
       title: body["title"],
       description: typeof body["description"] === "string" ? body["description"] : void 0,
       components: body["components"],
-      edges: body["edges"],
-      throughlines: Array.isArray(body["throughlines"]) ? body["throughlines"] : void 0,
+      relations: body["relations"],
+      walkthroughs: Array.isArray(body["walkthroughs"]) ? body["walkthroughs"] : void 0,
       source: typeof body["source"] === "string" ? body["source"] : void 0,
       repo: body["repo"],
       repoRoot: typeof body["repoRoot"] === "string" ? body["repoRoot"] : void 0,
@@ -15809,9 +15937,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 +16038,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.38.0" : "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"