mewkit 1.15.0 → 1.16.1

package/NOTICE

@@ -0,0 +1,24 @@
+MeowKit (mewkit)
+Copyright (c) 2026 MeowKit Contributors
+
+This product is licensed under the MIT License (see LICENSE) and includes
+software ported from third-party sources under their own licenses:
+
+------------------------------------------------------------------------
+agent-flow — https://github.com/patoles/agent-flow (commit 59ccf4e)
+Copyright the agent-flow authors
+Licensed under the Apache License, Version 2.0.
+
+Portions of the loopback HTTP server lifecycle, the static-file handler
+(including its path-traversal guard), the cross-platform browser launcher,
+and the token-estimation heuristic were ported from agent-flow. The affected
+files carry an attribution header referencing this NOTICE:
+
+  - src/local-web/local-server.ts
+  - src/local-web/static-handler.ts
+  - src/local-web/open-browser.ts
+  - src/token-estimator/index.ts
+
+A copy of the Apache License, Version 2.0 is available at:
+  https://www.apache.org/licenses/LICENSE-2.0
+------------------------------------------------------------------------

package/README.md

@@ -26,7 +26,7 @@ npx mewkit <command>      # Runtime commands
 | `meowkit task new`  | Create structured task file from template                         |
 | `meowkit task list` | List active tasks with status                                     |
 | `meowkit capabilities` | Resolve installed skills/commands/tools for an intent (`list`, `explain`, `resolve`, `projections`) |
-| `meowkit orchviz`   | Live web visualizer for the active Claude Code session            |
+| `meowkit visual-plan` | Structured visual plan: validate/approve/edit/view + feedback loop |
 | `meowkit pack`      | `list` / `add <pack>` / `remove <pack>` — manage installed domains |
 | `meowkit migrate`   | Export the `.claude/` setup to other coding agents (Codex, Cursor, …) |
 
@@ -143,80 +143,39 @@ npx mewkit memory --show        # Display lessons learned
 npx mewkit memory --clear       # Reset memory
 ```
 
-## Visualizer (`meowkit orchviz`)
+## Visual Plan (`meowkit visual-plan`)
 
-Live web visualizer for the active Claude Code session. Tails the JSONL
-transcript at `~/.claude/projects/<encoded-cwd>/<session>.jsonl`, parses it
-into structured `AgentEvent`s, and serves them at `http://127.0.0.1:<port>/`
-as a Canvas2D + d3-force interactive graph plus a live transcript panel and
-meowkit-specific overlays (Gate state, model tier, today's tokens, phase).
+Structured visual review for UI-bearing plans. A plan's `visual-plan/plan.json`
+(schema `visual-plan/v1`) is a coverage ledger + canvas (lanes, surface-locked
+artboards, semantic-HTML wireframes, connectors, annotations). The CLI validates
+and gates it; a transient 127.0.0.1 React studio renders and edits it.
 
 ```bash
-# Default: random port, auto-open browser
-npx mewkit orchviz
-
-# Custom flags
-npx mewkit orchviz --port 3001       # fixed port (0 = random)
-npx mewkit orchviz --no-open         # don't auto-launch browser
-npx mewkit orchviz --session <uuid>  # pin to a single session id
-npx mewkit orchviz --workspace .     # override watched workspace (default: cwd)
-npx mewkit orchviz --verbose         # print sanitized AgentEvents to stderr
-npx mewkit orchviz --log             # persist to .claude/logs/orchviz-<sid>.md
-npx mewkit orchviz --log /tmp/run.md # custom path (must end .md)
+# Deterministic contract commands
+npx mewkit visual-plan validate <plan-dir> [--json]     # schema + coverage + refs + safe-HTML + hashes
+npx mewkit visual-plan status <plan-dir> [--json]       # coverage summary + review status
+npx mewkit visual-plan approve <plan-dir> --revision <n> # single writer of review.status (Gate 1)
+npx mewkit visual-plan rehash <plan-dir>                # refresh source hashes (clears approval)
+npx mewkit visual-plan export <plan-dir> --format html  # self-contained plan.html from the artifact
+
+# Transient studio (127.0.0.1, exits with the process)
+npx mewkit visual-plan view <plan-dir> [--no-open] [--port N]   # read-only
+npx mewkit visual-plan edit <plan-dir> [--force]               # editable (single-editor lock)
+
+# Feedback loop
+npx mewkit visual-plan prepare-feedback <plan-dir> --ops <f.json>          # freeze an immutable batch
+npx mewkit visual-plan apply-feedback <plan-dir> --batch <id> --check      # pre-apply stale gate
+npx mewkit visual-plan apply-feedback <plan-dir> --batch <id> --receipt <f> # record per-op outcomes
+npx mewkit visual-plan patch <plan-dir> --op <op.json>                     # apply one typed visual op
 ```
 
-**Security:** server binds 127.0.0.1 only; Host-header guarded against DNS
-rebinding; SSE frames sanitized (ANSI strip + strict-prefix secret scrub on
-`sk-…`, `ghp_…`, `AKIA…`, PEM blocks); path traversal blocked.
-
-**Limitations (v1):** simplified canvas renderer (no bloom / detail panels /
-multi-session tabs); v1.1 ports the full agent-flow visualizer. Ported (in
-part) from [`patoles/agent-flow`](https://github.com/patoles/agent-flow)
-under the Apache-2.0 license — see `NOTICE`.
-
-### orchviz API Endpoints (v1.2)
-
-The orchviz server exposes these HTTP endpoints on `http://127.0.0.1:<port>`:
-
-**GET /api/plans** — list non-archived plans sorted by mtime (newest first):
-```bash
-curl http://127.0.0.1:3001/api/plans
-# { "plans": [{ "slug": "260501-my-plan", "title": "...", "status": "draft", ... }] }
-```
-
-**GET /api/plan?slug=\<slug\>** — full plan state with per-phase ETags:
-```bash
-curl "http://127.0.0.1:3001/api/plan?slug=260501-my-plan"
-# { "plan": { ... }, "phaseEtags": { "1": "<hex64>", "2": "<hex64>" }, "readonly": true }
-# Omit ?slug= to get the most-recently-modified plan.
-```
-
-**Read-only by default.** The visualizer is a viewer, not an editor — graph,
-plan tree, and todos all render read-only. The hamburger drawer browses the
-plan tree (plan → phase → todo) without exposing edit affordances. To opt
-into write mode (legacy todo-toggle endpoint), launch with
-`MEOWKIT_ORCHVIZ_WRITABLE=1`. The legacy `MEOWKIT_ORCHVIZ_READONLY=0` flag
-also opts in for backwards compatibility; `MEOWKIT_ORCHVIZ_READONLY=1`
-forces read-only as a defensive lock.
-
-**POST /api/plan/todo** — toggle a todo checkbox (write mode only):
-```bash
-# Default (no env): returns 405 { "error": "readonly" }
-MEOWKIT_ORCHVIZ_WRITABLE=1 npx mewkit orchviz   # opt in to write mode
-
-curl -X POST http://127.0.0.1:3001/api/plan/todo \
-  -H "Content-Type: application/json" \
-  -H "Origin: http://127.0.0.1:3001" \
-  -d '{"slug":"260501-my-plan","phase":1,"todoIdx":0,"checked":true,"etag":"<hex64>"}'
-# 200: { "ok": true, "changed": true, "etag": "<new-hex64>", "archived": false }
-# 409: { "error": "stale", "currentEtag": "<latest-hex64>" }  → re-fetch and retry
-# 403: Origin header missing or not in allowlist
-# 405: server is in read-only mode (the default)
-```
-
-**Origin requirement:** POST requests must include `Origin: http://127.0.0.1:<port>`
-or `Origin: http://localhost:<port>`. This prevents cross-origin writes from
-browser tabs served by other origins.
+**Security:** the studio server binds 127.0.0.1 only, Host-header guarded against
+DNS rebinding, path-traversal blocked, with a strict CSP (`script-src 'self'`).
+Wireframe HTML is DOMPurify-sanitized at both save and render time via one shared
+allowlist. Writes use optimistic concurrency (`PATCH` requires `If-Match`; 409 on
+stale). These loopback primitives live in `src/local-web/`, ported in part from
+[`patoles/agent-flow`](https://github.com/patoles/agent-flow) under Apache-2.0 —
+see `NOTICE`.
 
 ## Related
 

package/dist/commands/visual-plan.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `visual-plan` command adapter — maps parsed argv into the visual-plan CLI
+ * dispatcher. Thin by design (mirrors how other commands wrap their domain
+ * module); all logic lives in `src/visual-plan/`.
+ */
+export interface VisualPlanArgs {
+    subcommand?: string;
+    planDir?: string;
+    revision?: string | number;
+    json?: boolean;
+    open?: boolean;
+    noOpen?: boolean;
+    force?: boolean;
+    port?: number;
+    format?: string;
+    ops?: string;
+    batch?: string;
+    check?: boolean;
+    receipt?: string;
+    op?: string;
+}
+export declare function visualPlan(args: VisualPlanArgs): Promise<void>;
+//# sourceMappingURL=visual-plan.d.ts.map

package/dist/commands/visual-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-plan.d.ts","sourceRoot":"","sources":["../../src/commands/visual-plan.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,cAAc;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBpE"}

package/dist/commands/visual-plan.js

@@ -0,0 +1,26 @@
+/**
+ * `visual-plan` command adapter — maps parsed argv into the visual-plan CLI
+ * dispatcher. Thin by design (mirrors how other commands wrap their domain
+ * module); all logic lives in `src/visual-plan/`.
+ */
+import { visualPlanCommand } from "../visual-plan/interface/cli.js";
+export async function visualPlan(args) {
+    const cliArgs = {
+        subcommand: args.subcommand,
+        planDir: args.planDir,
+        revision: args.revision,
+        json: args.json,
+        open: args.open,
+        noOpen: args.noOpen,
+        force: args.force,
+        port: args.port,
+        format: args.format,
+        ops: args.ops,
+        batch: args.batch,
+        check: args.check,
+        receipt: args.receipt,
+        op: args.op,
+    };
+    await visualPlanCommand(cliArgs);
+}
+//# sourceMappingURL=visual-plan.js.map

package/dist/commands/visual-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-plan.js","sourceRoot":"","sources":["../../src/commands/visual-plan.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAA0B,MAAM,iCAAiC,CAAC;AAmB5F,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAoB;IACpD,MAAM,OAAO,GAAsB;QAClC,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,EAAE,EAAE,IAAI,CAAC,EAAE;KACX,CAAC;IACF,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC"}

package/dist/core/capability.d.ts

@@ -14,12 +14,12 @@ export declare const TypedRequirementSchema: z.ZodObject<{
     id: z.ZodString;
     provenance: z.ZodDefault<z.ZodEnum<["authored", "inferred", "adapter", "unknown"]>>;
 }, "strip", z.ZodTypeAny, {
-    id: string;
     type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+    id: string;
     provenance: "unknown" | "authored" | "inferred" | "adapter";
 }, {
-    id: string;
     type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+    id: string;
     provenance?: "unknown" | "authored" | "inferred" | "adapter" | undefined;
 }>;
 export type TypedRequirement = z.infer<typeof TypedRequirementSchema>;
@@ -30,10 +30,10 @@ export declare const InvocationSchema: z.ZodObject<{
     id: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     id: string;
-    kind: "skill" | "agent" | "command" | "workflow" | "hook" | "none";
+    kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
 }, {
     id: string;
-    kind: "skill" | "agent" | "command" | "workflow" | "hook" | "none";
+    kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
 }>;
 export type Invocation = z.infer<typeof InvocationSchema>;
 /** The four independent host-support levels, per provider. Populated from adapter
@@ -78,10 +78,10 @@ export declare const VerificationSchema: z.ZodObject<{
     kind: z.ZodEnum<["command", "file", "runtime", "none", "unknown"]>;
     id: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    kind: "command" | "unknown" | "none" | "file" | "runtime";
+    kind: "unknown" | "none" | "command" | "file" | "runtime";
     id?: string | undefined;
 }, {
-    kind: "command" | "unknown" | "none" | "file" | "runtime";
+    kind: "unknown" | "none" | "command" | "file" | "runtime";
     id?: string | undefined;
 }>;
 export type Verification = z.infer<typeof VerificationSchema>;
@@ -105,22 +105,22 @@ export declare const CapabilityEntrySchema: z.ZodObject<{
         id: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         id: string;
-        kind: "skill" | "agent" | "command" | "workflow" | "hook" | "none";
+        kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
     }, {
         id: string;
-        kind: "skill" | "agent" | "command" | "workflow" | "hook" | "none";
+        kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
     }>;
     requirements: z.ZodDefault<z.ZodArray<z.ZodObject<{
         type: z.ZodEnum<["host_tool", "mcp_or_app", "external_binary", "subagent_surface", "skill_script", "lifecycle_event", "file_or_config"]>;
         id: z.ZodString;
         provenance: z.ZodDefault<z.ZodEnum<["authored", "inferred", "adapter", "unknown"]>>;
     }, "strip", z.ZodTypeAny, {
-        id: string;
         type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+        id: string;
         provenance: "unknown" | "authored" | "inferred" | "adapter";
     }, {
-        id: string;
         type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+        id: string;
         provenance?: "unknown" | "authored" | "inferred" | "adapter" | undefined;
     }>, "many">>;
     /** Set when this capability must acquire a task-scoped repo-context envelope before
@@ -157,10 +157,10 @@ export declare const CapabilityEntrySchema: z.ZodObject<{
         kind: z.ZodEnum<["command", "file", "runtime", "none", "unknown"]>;
         id: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        kind: "command" | "unknown" | "none" | "file" | "runtime";
+        kind: "unknown" | "none" | "command" | "file" | "runtime";
         id?: string | undefined;
     }, {
-        kind: "command" | "unknown" | "none" | "file" | "runtime";
+        kind: "unknown" | "none" | "command" | "file" | "runtime";
         id?: string | undefined;
     }>>;
     dependencies: z.ZodDefault<z.ZodObject<{
@@ -176,24 +176,28 @@ export declare const CapabilityEntrySchema: z.ZodObject<{
     /** field name → where that field's value came from. */
     provenance: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<["authored", "inferred", "adapter", "unknown"]>>>;
 }, "strip", z.ZodTypeAny, {
-    id: string;
-    kind: "skill" | "agent" | "command" | "workflow" | "hook" | "tool" | "context-service" | "state-service";
+    owner: string;
     description: string;
+    verification: {
+        kind: "unknown" | "none" | "command" | "file" | "runtime";
+        id?: string | undefined;
+    };
+    id: string;
+    provenance: Record<string, "unknown" | "authored" | "inferred" | "adapter">;
+    kind: "skill" | "tool" | "agent" | "command" | "workflow" | "hook" | "context-service" | "state-service";
     aliases: string[];
     sourcePath: string | null;
     inventoryId: string | null;
-    owner: string;
-    installedState: "installed" | "absent" | "unknown";
+    installedState: "unknown" | "installed" | "absent";
     intents: string[];
     whenToUse: string | null;
     invocation: {
         id: string;
-        kind: "skill" | "agent" | "command" | "workflow" | "hook" | "none";
+        kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
     };
-    provenance: Record<string, "unknown" | "authored" | "inferred" | "adapter">;
     requirements: {
-        id: string;
         type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+        id: string;
         provenance: "unknown" | "authored" | "inferred" | "adapter";
     }[];
     contextRequirement: {
@@ -206,33 +210,33 @@ export declare const CapabilityEntrySchema: z.ZodObject<{
         invocable: boolean;
         enforceable: boolean;
     }>;
-    verification: {
-        kind: "command" | "unknown" | "none" | "file" | "runtime";
-        id?: string | undefined;
-    };
     dependencies: {
         upstream: string[];
         downstream: string[];
     };
 }, {
     id: string;
-    kind: "skill" | "agent" | "command" | "workflow" | "hook" | "tool" | "context-service" | "state-service";
+    kind: "skill" | "tool" | "agent" | "command" | "workflow" | "hook" | "context-service" | "state-service";
     invocation: {
         id: string;
-        kind: "skill" | "agent" | "command" | "workflow" | "hook" | "none";
+        kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
     };
+    owner?: string | undefined;
     description?: string | undefined;
+    verification?: {
+        kind: "unknown" | "none" | "command" | "file" | "runtime";
+        id?: string | undefined;
+    } | undefined;
+    provenance?: Record<string, "unknown" | "authored" | "inferred" | "adapter"> | undefined;
     aliases?: string[] | undefined;
     sourcePath?: string | null | undefined;
     inventoryId?: string | null | undefined;
-    owner?: string | undefined;
-    installedState?: "installed" | "absent" | "unknown" | undefined;
+    installedState?: "unknown" | "installed" | "absent" | undefined;
     intents?: string[] | undefined;
     whenToUse?: string | null | undefined;
-    provenance?: Record<string, "unknown" | "authored" | "inferred" | "adapter"> | undefined;
     requirements?: {
-        id: string;
         type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+        id: string;
         provenance?: "unknown" | "authored" | "inferred" | "adapter" | undefined;
     }[] | undefined;
     contextRequirement?: {
@@ -245,10 +249,6 @@ export declare const CapabilityEntrySchema: z.ZodObject<{
         invocable: boolean;
         enforceable: boolean;
     }> | undefined;
-    verification?: {
-        kind: "command" | "unknown" | "none" | "file" | "runtime";
-        id?: string | undefined;
-    } | undefined;
     dependencies?: {
         upstream?: string[] | undefined;
         downstream?: string[] | undefined;
@@ -277,22 +277,22 @@ export declare const CapabilityManifestSchema: z.ZodObject<{
             id: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             id: string;
-            kind: "skill" | "agent" | "command" | "workflow" | "hook" | "none";
+            kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
         }, {
             id: string;
-            kind: "skill" | "agent" | "command" | "workflow" | "hook" | "none";
+            kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
         }>;
         requirements: z.ZodDefault<z.ZodArray<z.ZodObject<{
             type: z.ZodEnum<["host_tool", "mcp_or_app", "external_binary", "subagent_surface", "skill_script", "lifecycle_event", "file_or_config"]>;
             id: z.ZodString;
             provenance: z.ZodDefault<z.ZodEnum<["authored", "inferred", "adapter", "unknown"]>>;
         }, "strip", z.ZodTypeAny, {
-            id: string;
             type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+            id: string;
             provenance: "unknown" | "authored" | "inferred" | "adapter";
         }, {
-            id: string;
             type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+            id: string;
             provenance?: "unknown" | "authored" | "inferred" | "adapter" | undefined;
         }>, "many">>;
         /** Set when this capability must acquire a task-scoped repo-context envelope before
@@ -329,10 +329,10 @@ export declare const CapabilityManifestSchema: z.ZodObject<{
             kind: z.ZodEnum<["command", "file", "runtime", "none", "unknown"]>;
             id: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            kind: "command" | "unknown" | "none" | "file" | "runtime";
+            kind: "unknown" | "none" | "command" | "file" | "runtime";
             id?: string | undefined;
         }, {
-            kind: "command" | "unknown" | "none" | "file" | "runtime";
+            kind: "unknown" | "none" | "command" | "file" | "runtime";
             id?: string | undefined;
         }>>;
         dependencies: z.ZodDefault<z.ZodObject<{
@@ -348,24 +348,28 @@ export declare const CapabilityManifestSchema: z.ZodObject<{
         /** field name → where that field's value came from. */
         provenance: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<["authored", "inferred", "adapter", "unknown"]>>>;
     }, "strip", z.ZodTypeAny, {
-        id: string;
-        kind: "skill" | "agent" | "command" | "workflow" | "hook" | "tool" | "context-service" | "state-service";
+        owner: string;
         description: string;
+        verification: {
+            kind: "unknown" | "none" | "command" | "file" | "runtime";
+            id?: string | undefined;
+        };
+        id: string;
+        provenance: Record<string, "unknown" | "authored" | "inferred" | "adapter">;
+        kind: "skill" | "tool" | "agent" | "command" | "workflow" | "hook" | "context-service" | "state-service";
         aliases: string[];
         sourcePath: string | null;
         inventoryId: string | null;
-        owner: string;
-        installedState: "installed" | "absent" | "unknown";
+        installedState: "unknown" | "installed" | "absent";
         intents: string[];
         whenToUse: string | null;
         invocation: {
             id: string;
-            kind: "skill" | "agent" | "command" | "workflow" | "hook" | "none";
+            kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
         };
-        provenance: Record<string, "unknown" | "authored" | "inferred" | "adapter">;
         requirements: {
-            id: string;
             type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+            id: string;
             provenance: "unknown" | "authored" | "inferred" | "adapter";
         }[];
         contextRequirement: {
@@ -378,33 +382,33 @@ export declare const CapabilityManifestSchema: z.ZodObject<{
             invocable: boolean;
             enforceable: boolean;
         }>;
-        verification: {
-            kind: "command" | "unknown" | "none" | "file" | "runtime";
-            id?: string | undefined;
-        };
         dependencies: {
             upstream: string[];
             downstream: string[];
         };
     }, {
         id: string;
-        kind: "skill" | "agent" | "command" | "workflow" | "hook" | "tool" | "context-service" | "state-service";
+        kind: "skill" | "tool" | "agent" | "command" | "workflow" | "hook" | "context-service" | "state-service";
         invocation: {
             id: string;
-            kind: "skill" | "agent" | "command" | "workflow" | "hook" | "none";
+            kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
         };
+        owner?: string | undefined;
         description?: string | undefined;
+        verification?: {
+            kind: "unknown" | "none" | "command" | "file" | "runtime";
+            id?: string | undefined;
+        } | undefined;
+        provenance?: Record<string, "unknown" | "authored" | "inferred" | "adapter"> | undefined;
         aliases?: string[] | undefined;
         sourcePath?: string | null | undefined;
         inventoryId?: string | null | undefined;
-        owner?: string | undefined;
-        installedState?: "installed" | "absent" | "unknown" | undefined;
+        installedState?: "unknown" | "installed" | "absent" | undefined;
         intents?: string[] | undefined;
         whenToUse?: string | null | undefined;
-        provenance?: Record<string, "unknown" | "authored" | "inferred" | "adapter"> | undefined;
         requirements?: {
-            id: string;
             type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+            id: string;
             provenance?: "unknown" | "authored" | "inferred" | "adapter" | undefined;
         }[] | undefined;
         contextRequirement?: {
@@ -417,10 +421,6 @@ export declare const CapabilityManifestSchema: z.ZodObject<{
             invocable: boolean;
             enforceable: boolean;
         }> | undefined;
-        verification?: {
-            kind: "command" | "unknown" | "none" | "file" | "runtime";
-            id?: string | undefined;
-        } | undefined;
         dependencies?: {
             upstream?: string[] | undefined;
             downstream?: string[] | undefined;
@@ -428,24 +428,28 @@ export declare const CapabilityManifestSchema: z.ZodObject<{
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     entries: {
-        id: string;
-        kind: "skill" | "agent" | "command" | "workflow" | "hook" | "tool" | "context-service" | "state-service";
+        owner: string;
         description: string;
+        verification: {
+            kind: "unknown" | "none" | "command" | "file" | "runtime";
+            id?: string | undefined;
+        };
+        id: string;
+        provenance: Record<string, "unknown" | "authored" | "inferred" | "adapter">;
+        kind: "skill" | "tool" | "agent" | "command" | "workflow" | "hook" | "context-service" | "state-service";
         aliases: string[];
         sourcePath: string | null;
         inventoryId: string | null;
-        owner: string;
-        installedState: "installed" | "absent" | "unknown";
+        installedState: "unknown" | "installed" | "absent";
         intents: string[];
         whenToUse: string | null;
         invocation: {
             id: string;
-            kind: "skill" | "agent" | "command" | "workflow" | "hook" | "none";
+            kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
         };
-        provenance: Record<string, "unknown" | "authored" | "inferred" | "adapter">;
         requirements: {
-            id: string;
             type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+            id: string;
             provenance: "unknown" | "authored" | "inferred" | "adapter";
         }[];
         contextRequirement: {
@@ -458,10 +462,6 @@ export declare const CapabilityManifestSchema: z.ZodObject<{
             invocable: boolean;
             enforceable: boolean;
         }>;
-        verification: {
-            kind: "command" | "unknown" | "none" | "file" | "runtime";
-            id?: string | undefined;
-        };
         dependencies: {
             upstream: string[];
             downstream: string[];
@@ -471,23 +471,27 @@ export declare const CapabilityManifestSchema: z.ZodObject<{
 }, {
     entries: {
         id: string;
-        kind: "skill" | "agent" | "command" | "workflow" | "hook" | "tool" | "context-service" | "state-service";
+        kind: "skill" | "tool" | "agent" | "command" | "workflow" | "hook" | "context-service" | "state-service";
         invocation: {
             id: string;
-            kind: "skill" | "agent" | "command" | "workflow" | "hook" | "none";
+            kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
         };
+        owner?: string | undefined;
         description?: string | undefined;
+        verification?: {
+            kind: "unknown" | "none" | "command" | "file" | "runtime";
+            id?: string | undefined;
+        } | undefined;
+        provenance?: Record<string, "unknown" | "authored" | "inferred" | "adapter"> | undefined;
         aliases?: string[] | undefined;
         sourcePath?: string | null | undefined;
         inventoryId?: string | null | undefined;
-        owner?: string | undefined;
-        installedState?: "installed" | "absent" | "unknown" | undefined;
+        installedState?: "unknown" | "installed" | "absent" | undefined;
         intents?: string[] | undefined;
         whenToUse?: string | null | undefined;
-        provenance?: Record<string, "unknown" | "authored" | "inferred" | "adapter"> | undefined;
         requirements?: {
-            id: string;
             type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+            id: string;
             provenance?: "unknown" | "authored" | "inferred" | "adapter" | undefined;
         }[] | undefined;
         contextRequirement?: {
@@ -500,10 +504,6 @@ export declare const CapabilityManifestSchema: z.ZodObject<{
             invocable: boolean;
             enforceable: boolean;
         }> | undefined;
-        verification?: {
-            kind: "command" | "unknown" | "none" | "file" | "runtime";
-            id?: string | undefined;
-        } | undefined;
         dependencies?: {
             upstream?: string[] | undefined;
             downstream?: string[] | undefined;

package/dist/core/consolidation-ledger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consolidation-ledger.d.ts","sourceRoot":"","sources":["../../src/core/consolidation-ledger.ts"],"names":[],"mappings":"AAWA;;kFAEkF;AAClF,MAAM,MAAM,mBAAmB,GAC5B,WAAW,GACX,aAAa,GACb,gBAAgB,GAChB,cAAc,GACd,YAAY,GACZ,WAAW,CAAC;AAEf,MAAM,WAAW,sBAAsB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,+EAA+E;IAC/E,cAAc,EAAE,MAAM,CAAC;IACvB,4FAA4F;IAC5F,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IAC5D,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACtC,0FAA0F;IAC1F,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,gGAAgG;IAChG,iBAAiB,EAAE,KAAK,CAAC;IACzB,yEAAyE;IACzE,cAAc,EAAE,MAAM,EAAE,CAAC;CACzB;AAID,8FAA8F;AAC9F,eAAO,MAAM,oBAAoB,EAAE,sBAAsB,EA+HxD,CAAC;AAEF,iCAAiC;AACjC,wBAAgB,sBAAsB,IAAI,sBAAsB,EAAE,CAEjE"}
+{"version":3,"file":"consolidation-ledger.d.ts","sourceRoot":"","sources":["../../src/core/consolidation-ledger.ts"],"names":[],"mappings":"AAaA;;kFAEkF;AAClF,MAAM,MAAM,mBAAmB,GAC5B,WAAW,GACX,aAAa,GACb,gBAAgB,GAChB,cAAc,GACd,YAAY,GACZ,WAAW,CAAC;AAEf,MAAM,WAAW,sBAAsB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,+EAA+E;IAC/E,cAAc,EAAE,MAAM,CAAC;IACvB,4FAA4F;IAC5F,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IAC5D,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACtC,0FAA0F;IAC1F,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,gGAAgG;IAChG,iBAAiB,EAAE,KAAK,CAAC;IACzB,yEAAyE;IACzE,cAAc,EAAE,MAAM,EAAE,CAAC;CACzB;AAID,8FAA8F;AAC9F,eAAO,MAAM,oBAAoB,EAAE,sBAAsB,EA+HxD,CAAC;AAEF,iCAAiC;AACjC,wBAAgB,sBAAsB,IAAI,sBAAsB,EAAE,CAEjE"}