@rosthq/cli 0.7.121 → 0.7.122

package/dist/generated/command-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-manifest.d.ts","sourceRoot":"","sources":["../../src/generated/command-manifest.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,eAAO,MAAM,gBAAgB,EAAE,SAAS,oBAAoB,EAqS3D,CAAC"}
+{"version":3,"file":"command-manifest.d.ts","sourceRoot":"","sources":["../../src/generated/command-manifest.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,eAAO,MAAM,gBAAgB,EAAE,SAAS,oBAAoB,EAuS3D,CAAC"}

package/dist/index.js

@@ -36766,6 +36766,82 @@ var charterApproveInputSchema = external_exports.object({
   message: "Provide seat_id or charter_version_id.",
   path: ["seat_id"]
 });
+var charterSignalDeclarationNameSchema = external_exports.string().trim().min(1).max(120);
+var charterSignalResolutionSchema = external_exports.discriminatedUnion("action", [
+  external_exports.object({
+    declaration_name: charterSignalDeclarationNameSchema,
+    action: external_exports.literal("adopt_existing"),
+    measurable_id: uuidSchema18
+  }).strict(),
+  external_exports.object({
+    declaration_name: charterSignalDeclarationNameSchema,
+    action: external_exports.literal("move_existing"),
+    measurable_id: uuidSchema18
+  }).strict(),
+  external_exports.object({
+    declaration_name: charterSignalDeclarationNameSchema,
+    action: external_exports.literal("create_new")
+  }).strict()
+]);
+var charterReconcileSignalsInputSchema = external_exports.object({
+  charter_version_id: uuidSchema18,
+  // The stale-draft guard: `charter_versions.edit_revision` starts at 1, so 0 is
+  // never a real revision.
+  expected_edit_revision: external_exports.number().int().min(1),
+  signal_resolutions: external_exports.array(charterSignalResolutionSchema).min(1),
+  apply_seat_type: external_exports.boolean().default(false)
+}).strict();
+var charterSignalGoalBindingSchema = external_exports.object({
+  goal_id: uuidSchema18,
+  goal_title: external_exports.string(),
+  // Null for a company objective, which owns no Seat. A `drives_status` binding on a
+  // seatless goal can never match a destination Seat, so movement fails closed.
+  goal_seat_id: uuidSchema18.nullable(),
+  role: external_exports.enum(["drives_status", "informs"])
+}).strict();
+var charterSignalCandidateSchema = external_exports.object({
+  measurable_id: uuidSchema18,
+  owner_seat_id: uuidSchema18,
+  owner_seat_name: external_exports.string(),
+  stored_source: external_exports.enum(["human", "agent", "integration"]),
+  reading_count: external_exports.number().int().min(0),
+  latest_reading: external_exports.object({
+    value: external_exports.number(),
+    period_start: external_exports.string(),
+    confirmed: external_exports.boolean()
+  }).strict().nullable(),
+  goal_bindings: external_exports.array(charterSignalGoalBindingSchema),
+  // Bindings in ANY status, draft included — "a connected source is bound", not "a source is
+  // actively feeding it". The preview's warning copy is worded to match.
+  source_binding_count: external_exports.number().int().min(0),
+  // What choosing THIS candidate would cost or carry. Present on every candidate, including
+  // each side of an ambiguous match, which is where the differences decide the answer.
+  warnings: external_exports.array(external_exports.string())
+}).strict();
+var charterSignalReconciliationItemSchema = external_exports.object({
+  declaration_name: external_exports.string(),
+  status: external_exports.enum(["linked", "candidate", "ambiguous", "missing"]),
+  linked_measurable_id: uuidSchema18.nullable(),
+  candidates: external_exports.array(charterSignalCandidateSchema),
+  // A DERIVED suggestion, never an applied one: `null` whenever a human must choose
+  // (ambiguous), whenever nothing matches (missing), or when the declaration is already
+  // linked. Approval still requires the explicit action.
+  recommended_action: external_exports.enum(["adopt_existing", "move_existing"]).nullable(),
+  // What this choice would cost or carry — a cadence the reading history locks, a
+  // status-driving goal on another Seat that blocks a move. Empty when nothing is at risk.
+  warnings: external_exports.array(external_exports.string())
+}).strict();
+var charterPreviewSignalReconciliationInputSchema = external_exports.object({
+  charter_version_id: uuidSchema18
+}).strict();
+var charterPreviewSignalReconciliationOutputSchema = external_exports.object({
+  charter_version_id: uuidSchema18,
+  seat_id: uuidSchema18,
+  // Pass this back as `expected_edit_revision` when reconciling, so a draft edited after
+  // the preview cannot be reconciled against a stale reading of it.
+  edit_revision: external_exports.number().int().min(1),
+  items: external_exports.array(charterSignalReconciliationItemSchema)
+}).strict();
 var charterDraftAllInputSchema = external_exports.object({}).strict();
 var charterDraftSkipReasonSchema = external_exports.enum(["seat_not_active", "charter_exists"]);
 var charterDraftAllOutputSchema = withCommandEffect({
@@ -52403,11 +52479,11 @@ When operating through CLI or MCP, create fewer seats first and ask for confirma
     order: 30,
     title: "Charter design playbook",
     summary: "How to draft strong Charters that work for human, agent, and hybrid seats.",
-    version: "2026-07-26.3",
+    version: "2026-07-29.1",
     public: true,
     audiences: ["human", "cli", "mcp", "in_app_agent"],
     stages: ["charter_design", "staffing"],
-    relatedCommandIds: ["charter.draft", "charter.draft_all", "charter.update_draft", "charter.approve", "charter.skip", "charter.apply_seat_type_recommendation", "charter.sign_manifest", "charter.list", "charter.get", "confirmation.approve"],
+    relatedCommandIds: ["charter.draft", "charter.draft_all", "charter.update_draft", "charter.approve", "charter.preview_signal_reconciliation", "charter.reconcile_signals", "charter.skip", "charter.apply_seat_type_recommendation", "charter.sign_manifest", "charter.list", "charter.get", "confirmation.approve"],
     legal: {
       publicRisk: "low",
       notes: [
@@ -52465,6 +52541,14 @@ In the app, \`/charters\` is both a drafting queue and a governance library. It
 
 Daily and weekly measurable rows can carry Signal metadata: unit, numeric target, direction, cadence, and source. When a human approves a Charter, those structured measurables materialize into tenant Signal definitions for that seat. Free-text, monthly, and quarterly measurable prose remains accountability text until a human converts it into a supported structured Signal or creates the Signal separately.
 
+## When a declared Signal already exists
+
+Preview first. Approval requires an explicit choice for a declaration that COLLIDES with an active exact-name Signal and is not already linked to one: adopt it if it is already owned by the Charter Seat, move it if another Seat owns it, or deliberately create a second Signal. A declaration nothing matches is created automatically, and one already linked to a Signal takes no choice. Adoption and movement preserve the Signal ID, readings, and compatible goal bindings.
+
+\`charter.preview_signal_reconciliation\` is the owner-only dry run: per declaration it reports whether the declaration is already linked, which existing Signals match its name, who owns them, how much reading history and how many goal links they carry, the action that fits, and what that action would cost. \`charter.reconcile_signals\` then approves the Charter carrying one explicit decision per COLLIDING, UNLINKED declaration, and takes the \`edit_revision\` the preview returned so a draft edited in between is refused rather than reconciled against a stale reading.
+
+Both commands are owner-only. Ordinary \`charter.approve\` stays seat-scoped and cannot take ownership of another Seat's Signal: when a declared name collides, it refuses and says an owner must decide. A Signal that already sets the status of a goal owned by another Seat cannot be moved until that goal's status driver is rebound \u2014 informative goal indicators survive a move.
+
 ## When to stop for confirmation
 
 \`charter.approve\`, \`charter.skip\`, \`charter.apply_seat_type_recommendation\`, and \`charter.sign_manifest\` are \`human_required\`. Over MCP \`rost_approve_charter\` returns a pending confirmation, not an activation. Approving a Charter, signing a permission manifest, or expanding authority is a human act recorded against \`decided_by\`. An agent prepares the draft and surfaces the approve link; it does not approve. See the confirmations guide.
@@ -53080,7 +53164,7 @@ External connectors are being rolled out provider by provider, conservatively (r
     order: 48,
     title: "CLI and MCP installation guide",
     summary: "Install the public CLI, register remote token-backed MCP clients, and find the full command and tool catalog.",
-    version: "2026-07-27.10",
+    version: "2026-07-29.1",
     public: true,
     audiences: ["human", "cli", "mcp", "in_app_agent"],
     stages: ["company_setup", "staffing"],
@@ -53790,6 +53874,8 @@ Several rows here are seat-operating commands (\`task.create\`, the \`signal.*\`
 | \`rost_update_charter_draft\` | \`charter.update_draft\` | Update a draft Charter document. | Seat or tenant-admin | Call with \`charter_version_id\` and the full \`doc\`. |
 | \`rost_set_charter\` | \`charter.set\` | Create or replace a seat's draft Charter from a full document in one call. | Seat or tenant-admin | Call with \`seat_id\` and \`doc\`; \`approve\` activates it (human gate). |
 | \`rost_approve_charter\` | \`charter.approve\` | Approve a draft Charter as a human owner. | Seat or tenant-admin | Expect confirmation when authority changes. |
+| \`rost_preview_charter_signal_reconciliation\` | \`charter.preview_signal_reconciliation\` | Owner-only dry run of how a draft Charter's declared Signals resolve against the Signals the company already tracks. | Tenant-admin | Call with \`charter_version_id\`; reads only, and returns the \`edit_revision\` to reconcile with. |
+| \`rost_reconcile_charter_signals\` | \`charter.reconcile_signals\` | Owner-only Charter approval carrying an explicit adopt / move / create decision per colliding Signal declaration. | Tenant-admin | Preview first; pass its \`edit_revision\` and one resolution per colliding, unlinked declaration. |
 | \`rost_skip_charter_draft\` | \`charter.skip\` | Mark a Charter draft as skipped. | Seat or tenant-admin | Call only when a human defers the seat. |
 | \`rost_apply_charter_seat_type_recommendation\` | \`charter.apply_seat_type_recommendation\` | Apply a Charter's seat-type recommendation. | Seat or tenant-admin | Call after reviewing the draft. |
 | \`rost_sign_charter_manifest\` | \`charter.sign_manifest\` | Request human confirmation for a permission manifest. | Seat or tenant-admin | Use after tool permissions are reviewed. |
@@ -58233,6 +58319,8 @@ var COMMAND_MANIFEST = [
   { "id": "charter.draft_all", "namespace": "charter", "action": "draft_all", "title": "Draft all charters", "description": "Draft Charters for every eligible seat in a tenant.", "requiredScope": "tenant", "confirmation": "none", "exposeOverMcp": true, "fields": [], "hasComplexInput": false, "help": "Draft Charters in onboarding order after the Responsibility Graph has enough seat clarity.", "example": {} },
   { "id": "charter.get", "namespace": "charter", "action": "get", "title": "Get Charter", "description": "Return a Charter version with its supersession history and latest dry-run status.", "requiredScope": "tenant", "confirmation": "none", "exposeOverMcp": true, "fields": [{ "name": "charter_version_id", "flag": "charter-version-id", "type": "string", "required": true }], "hasComplexInput": false, "help": "Read a Charter with its supersession history and dry-run status before approving or signing a manifest." },
   { "id": "charter.list", "namespace": "charter", "action": "list", "title": "List Charters", "description": "List Charter versions in the tenant, optionally filtered by seat or status.", "requiredScope": "tenant", "confirmation": "none", "exposeOverMcp": true, "fields": [{ "name": "seat_id", "flag": "seat-id", "type": "string", "required": false }, { "name": "status", "flag": "status", "type": "enum", "required": false, "enumValues": ["draft", "active", "superseded"] }], "hasComplexInput": false, "help": "List Charter versions to find the right draft or active version id before reading or amending it." },
+  { "id": "charter.preview_signal_reconciliation", "namespace": "charter", "action": "preview_signal_reconciliation", "title": "Preview Charter Signal reconciliation", "description": "Owner-only dry run: for each Signal a draft Charter declares, show whether it is already linked, which existing Signals match its name, who owns them, how much reading history and how many goal links they carry, the action that fits, and what it would cost. Reads only \u2014 nothing is changed. Approval needs an explicit choice only for a declaration that COLLIDES with an existing Signal and is not already linked: a declaration nothing matches is created automatically, and one already linked to a Signal takes no choice.", "requiredScope": "tenant_admin", "confirmation": "none", "exposeOverMcp": true, "fields": [{ "name": "charter_version_id", "flag": "charter-version-id", "type": "string", "required": true }], "hasComplexInput": false, "help": "Preview first. Approval requires an explicit choice when an exact-name active Signal exists: adopt it if it is already owned by the Charter Seat, move it if another Seat owns it, or deliberately create a second Signal. Adoption and movement preserve the Signal ID, readings, and compatible goal bindings." },
+  { "id": "charter.reconcile_signals", "namespace": "charter", "action": "reconcile_signals", "title": "Reconcile Charter Signals", "description": "Owner-only: approve a draft Charter with an explicit decision for each declared Signal that collides with one the company already tracks and is not already linked to one \u2014 adopt the existing Signal when this Seat owns it, move it to this Seat, or deliberately create a second one. Adoption and movement keep the Signal's id, its readings, and its compatible goal links. Preview first, and pass that preview's edit_revision.", "requiredScope": "tenant_admin", "confirmation": "human_required", "exposeOverMcp": true, "fields": [{ "name": "charter_version_id", "flag": "charter-version-id", "type": "string", "required": true }, { "name": "expected_edit_revision", "flag": "expected-edit-revision", "type": "integer", "required": true }, { "name": "apply_seat_type", "flag": "apply-seat-type", "type": "boolean", "required": false }], "hasComplexInput": true, "help": "Owner-only Charter approval carrying one explicit decision per COLLIDING, UNLINKED Signal declaration \u2014 a declaration nothing matches is created automatically, and an already-linked one takes no choice. Take the preview first and pass its edit_revision; adoption and movement keep the Signal's id, readings, and compatible goal bindings, and a cross-Seat status driver blocks a move." },
   { "id": "charter.set", "namespace": "charter", "action": "set", "title": "Set charter", "description": "Create or replace a seat's draft Charter from a full document in one call; approve activates it as a human owner.", "requiredScope": "seat", "confirmation": "human_required", "exposeOverMcp": true, "fields": [{ "name": "seat_id", "flag": "seat-id", "type": "string", "required": true }, { "name": "approve", "flag": "approve", "type": "boolean", "required": false }], "hasComplexInput": true, "help": "Create or replace a seat's draft Charter from a full document in one call; read the charter authoring deep-dive first. Approving activates the seat's contract and is a human decision.", "example": { "seat_id": "0190aaaa-aaaa-7aaa-8aaa-aaaaaaaaaaaa", "doc": { "payload_version": 1, "purpose": "AP intake clerk: draft accounts-payable invoice entries from inbound vendor emails for human review.", "accountabilities": [{ "title": "Draft every inbound invoice", "description": "Convert each inbound vendor invoice into a draft AP entry with the correct vendor, amount, and GL coding within one business day." }, { "title": "Flag discrepancies", "description": "Surface duplicate, mismatched, or out-of-policy invoices as Friction issues instead of drafting them silently." }], "decision_authority": { "autonomous": [{ "action": "Draft AP entries and propose GL coding from inbound invoices", "condition": "Allowed when the vendor is known and the amount is within the standard purchase range.", "rationale": "Drafting is reversible and reviewed by a human before posting.", "unanswered_boundary": false }], "approval": [{ "action": "Post an invoice or send any vendor-facing message", "condition": "Require explicit human approval before posting or sending.", "rationale": "Posting and sending are durable, money-moving actions.", "unanswered_boundary": false }], "escalate": [{ "action": "Unknown vendor, payment over the approval threshold, or a suspected duplicate", "condition": "Always escalate to the Steward before acting.", "rationale": "Conservative default for ambiguous, irreversible, or financial exposure.", "unanswered_boundary": true }] }, "escalation_rules": ["Escalate any invoice over $5,000 or from a vendor not already in the ledger.", "Escalate when an invoice appears to duplicate one already drafted or posted."], "measurables": [{ "name": "Invoices drafted within one business day", "target": "100%", "cadence": "weekly", "source": "agent" }, { "name": "Discrepancies caught before posting", "target": "\u2265 95%", "cadence": "monthly", "source": "human" }], "permission_manifest": [{ "tool": "ap.invoices.read", "scope": "Read inbound invoices and the vendor ledger.", "granted": true, "rationale": "Needed to draft entries from source invoices." }, { "tool": "email.draft", "scope": "Draft vendor replies for human review; never send.", "granted": true, "rationale": "Lets the seat prepare clarifications without taking a send action." }], "budget": { "monthly_usd": null, "approval_required_over_usd": 0, "notes": "No autonomous spend; any spend requires Steward approval until a budget is set." }, "unanswered_boundaries": ["Approval threshold for auto-posting", "Vendor onboarding authority"], "seat_type_recommendation": { "recommendation": "agent", "rationale": "The work is high-volume, rule-bound, and fully reviewable, which suits a draft-and-confirm agent under a human Steward.", "confidence": 0.8 } }, "approve": false } },
   { "id": "charter.show_markdown", "namespace": "charter", "action": "show_markdown", "title": "Show Charter as markdown", "description": "Compose a seat's active or latest Charter into a clean, human-skimmable markdown card for review.", "requiredScope": "tenant", "confirmation": "none", "exposeOverMcp": true, "fields": [{ "name": "seat_id", "flag": "seat-id", "type": "string", "required": true }], "hasComplexInput": false, "help": "Render a seat's active or latest Charter as a clean markdown card to show your human a quick review." },
   { "id": "charter.sign_manifest", "namespace": "charter", "action": "sign_manifest", "title": "Sign charter manifest", "description": "Request human confirmation for a Charter permission manifest.", "requiredScope": "seat", "confirmation": "human_required", "exposeOverMcp": true, "fields": [{ "name": "charter_version_id", "flag": "charter-version-id", "type": "string", "required": true }], "hasComplexInput": false, "help": "Sign tool manifests only when the Charter explains why the tool is needed and how it is bounded." },