@ikenga/contract 0.12.0 → 0.13.0

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAE5D,gFAAgF;;YA/BhF,4DAA4D;;YAE5D,0DAA0D;;;;;;;;;QA+B1D;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAaH,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,eAAO,MAAM,mBAAmB;IAC9B,qBAAqB;;IAErB,qBAAqB;;IAErB;;;;;OAKG;;IAEH,4EAA4E;;IAE5E,2EAA2E;;IAE3E;;;;OAIG;;IAEH;;;;;;;OAOG;;;;;;;;;;;;;;;;;;EAEH,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,mBAAmB;;IAE9B,wDAAwD;;;QAnCxD,qBAAqB;;QAErB,qBAAqB;;QAErB;;;;;WAKG;;QAEH,4EAA4E;;QAE5E,2EAA2E;;QAE3E;;;;WAIG;;QAEH;;;;;;;WAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUH,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAE5D,gFAAgF;;YA/BhF,4DAA4D;;YAE5D,0DAA0D;;;;;;;;;QA+B1D;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAaH,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,eAAO,MAAM,mBAAmB;IAC9B,qBAAqB;;IAErB,qBAAqB;;IAErB;;;;;OAKG;;IAEH,4EAA4E;;IAE5E,2EAA2E;;IAE3E;;;;OAIG;;IAEH;;;;;;;OAOG;;;;;;;;;;;;;;;;;;EAEH,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,mBAAmB;;IAE9B,wDAAwD;;;QAnCxD,qBAAqB;;QAErB,qBAAqB;;QAErB;;;;;WAKG;;QAEH,4EAA4E;;QAE5E,2EAA2E;;QAE3E;;;;WAIG;;QAEH;;;;;;;WAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUH,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/window.d.ts

@@ -24,14 +24,14 @@ export declare const WindowDescriptorSchema: z.ZodObject<{
      */
     layout_key: z.ZodString;
 }, "strict", z.ZodTypeAny, {
-    label: string;
     kind: "primary" | "single-surface" | "pane-set" | "workspace";
+    label: string;
     surface_set: string[];
     project_id: string | null;
     layout_key: string;
 }, {
-    label: string;
     kind: "primary" | "single-surface" | "pane-set" | "workspace";
+    label: string;
     layout_key: string;
     surface_set?: string[] | undefined;
     project_id?: string | null | undefined;
@@ -52,11 +52,11 @@ export declare const WindowEventTargetSchema: z.ZodDiscriminatedUnion<"kind", [z
     kind: z.ZodLiteral<"window">;
     label: z.ZodString;
 }, "strict", z.ZodTypeAny, {
-    label: string;
     kind: "window";
-}, {
     label: string;
+}, {
     kind: "window";
+    label: string;
 }>]>;
 export type WindowEventTarget = z.infer<typeof WindowEventTargetSchema>;
 /**
@@ -80,11 +80,11 @@ export declare const WindowEventEnvelopeSchema: z.ZodObject<{
         kind: z.ZodLiteral<"window">;
         label: z.ZodString;
     }, "strict", z.ZodTypeAny, {
-        label: string;
         kind: "window";
-    }, {
         label: string;
+    }, {
         kind: "window";
+        label: string;
     }>]>;
     payload: z.ZodUnknown;
 }, "strict", z.ZodTypeAny, {
@@ -94,8 +94,8 @@ export declare const WindowEventEnvelopeSchema: z.ZodObject<{
     target: {
         kind: "broadcast";
     } | {
-        label: string;
         kind: "window";
+        label: string;
     };
     payload?: unknown;
 }, {
@@ -105,8 +105,8 @@ export declare const WindowEventEnvelopeSchema: z.ZodObject<{
     target: {
         kind: "broadcast";
     } | {
-        label: string;
         kind: "window";
+        label: string;
     };
     payload?: unknown;
 }>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikenga/contract",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Shared contract for the Ikenga pkg system: manifest schema, RPC types, Engine interface, capability scopes.",
   "license": "Apache-2.0",
   "repository": {
@@ -59,6 +59,10 @@
     "./window": {
       "types": "./dist/window.d.ts",
       "import": "./dist/window.js"
+    },
+    "./action-frontmatter": {
+      "types": "./dist/action-frontmatter.d.ts",
+      "import": "./dist/action-frontmatter.js"
     }
   },
   "files": [
@@ -90,7 +94,8 @@
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "tsx": "^4.21.0",
-    "typescript": "^5.4.0"
+    "typescript": "^5.4.0",
+    "yaml": "^1.10.3"
   },
   "publishConfig": {
     "access": "public"

package/src/action-frontmatter.test.ts

@@ -0,0 +1,219 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+import YAML from 'yaml';
+
+import {
+  ActionFrontmatter,
+  CapabilityEnum,
+  DomainEnum,
+  RunBinding,
+  SetupSpec,
+  Trigger,
+  UxModeEnum,
+} from './action-frontmatter.js';
+
+// ─── unit: sub-schemas ──────────────────────────────────────────────────────
+
+test('DomainEnum: the eight domains + skill-core', () => {
+  for (const d of [
+    'tasks',
+    'mail',
+    'outbound',
+    'sales',
+    'finance',
+    'content',
+    'research',
+    'strategy',
+    'skill-core',
+  ]) {
+    assert.equal(DomainEnum.parse(d), d);
+  }
+  assert.throws(() => DomainEnum.parse('marketing'));
+});
+
+test('UxModeEnum: exactly the five modes', () => {
+  for (const m of ['confirm', 'silent', 'form', 'streaming', 'approve']) {
+    assert.equal(UxModeEnum.parse(m), m);
+  }
+  assert.throws(() => UxModeEnum.parse('modal'));
+});
+
+test('RunBinding: chat_prompt requires a non-empty prompt', () => {
+  const r = RunBinding.parse({ kind: 'chat_prompt', prompt: '# do the thing' });
+  assert.equal(r.kind, 'chat_prompt');
+  assert.throws(() => RunBinding.parse({ kind: 'chat_prompt', prompt: '' }));
+});
+
+test('RunBinding: sidecar defaults args to []', () => {
+  const r = RunBinding.parse({ kind: 'sidecar', sidecar_id: 'pa-x' });
+  assert.deepEqual(r.kind === 'sidecar' ? r.args : null, []);
+});
+
+test('Trigger: schedule needs a cron; unknown kind rejected', () => {
+  const t = Trigger.parse({ kind: 'schedule', cron: '30 */4 * * *', label: 'x' });
+  assert.equal(t.kind, 'schedule');
+  assert.throws(() => Trigger.parse({ kind: 'timer', every: '5m' }));
+});
+
+test('CapabilityEnum: closed set', () => {
+  for (const c of ['sqlite', 'mcp', 'sidecar', 'network', 'fs', 'secrets', 'chat']) {
+    assert.equal(CapabilityEnum.parse(c), c);
+  }
+  assert.throws(() => CapabilityEnum.parse('gpu'));
+});
+
+test('SetupSpec: template_version must be a positive int', () => {
+  const s = SetupSpec.parse({ mode: 'interview', template_version: 1 });
+  assert.equal(s.template_version, 1);
+  assert.throws(() => SetupSpec.parse({ mode: 'interview', template_version: 0 }));
+});
+
+// ─── unit: ActionFrontmatter refinements ────────────────────────────────────
+
+test('ActionFrontmatter: name must be kebab-case', () => {
+  const base = {
+    name: 'draft-reply',
+    description: 'x',
+    domain: 'mail',
+    ux_mode: 'approve',
+    run: { kind: 'chat_prompt', prompt: 'x' },
+  };
+  assert.equal(ActionFrontmatter.parse(base).name, 'draft-reply');
+  assert.throws(() => ActionFrontmatter.parse({ ...base, name: 'DraftReply' }));
+});
+
+test('ActionFrontmatter: .strict rejects unknown top-level keys', () => {
+  assert.throws(() =>
+    ActionFrontmatter.parse({
+      name: 'x',
+      description: 'x',
+      domain: 'mail',
+      ux_mode: 'approve',
+      run: { kind: 'chat_prompt', prompt: 'x' },
+      bogus: true,
+    }),
+  );
+});
+
+test('ActionFrontmatter: setup block only valid on the setup action', () => {
+  // Non-setup action carrying a setup block → rejected.
+  assert.throws(() =>
+    ActionFrontmatter.parse({
+      name: 'sweep',
+      description: 'x',
+      domain: 'tasks',
+      ux_mode: 'approve',
+      run: { kind: 'chat_prompt', prompt: 'x' },
+      setup: { mode: 'interview', template_version: 1 },
+    }),
+  );
+  // setup action missing its setup block → rejected.
+  assert.throws(() =>
+    ActionFrontmatter.parse({
+      name: 'setup',
+      description: 'x',
+      domain: 'skill-core',
+      ux_mode: 'streaming',
+      run: { kind: 'chat_prompt', prompt: 'x' },
+    }),
+  );
+  // setup action with its setup block → ok.
+  const ok = ActionFrontmatter.parse({
+    name: 'setup',
+    description: 'x',
+    domain: 'skill-core',
+    ux_mode: 'streaming',
+    run: { kind: 'chat_prompt', prompt: 'x' },
+    setup: { mode: 'ai_infer', template_version: 1, infer_sources: ['README.md'] },
+  });
+  assert.equal(ok.setup?.mode, 'ai_infer');
+});
+
+test('ActionFrontmatter: depends_on refuses non-skill-core targets', () => {
+  assert.throws(() =>
+    ActionFrontmatter.parse({
+      name: 'x',
+      description: 'x',
+      domain: 'mail',
+      ux_mode: 'approve',
+      run: { kind: 'chat_prompt', prompt: 'x' },
+      depends_on: ['mail'],
+    }),
+  );
+});
+
+// ─── conformance: parse every real installed action file ────────────────────
+
+/** Extract the YAML frontmatter block between the leading `---` fences.
+ *  Mirrors the Rust `extract_frontmatter` in skill_actions.rs. Returns null
+ *  when the file does not open with a `---` fence (prose-only skill docs). */
+function extractFrontmatter(body: string): string | null {
+  const src = body.replace(/^/, '');
+  const lines = src.split('\n');
+  if (lines[0]?.trim() !== '---') return null;
+  const close = lines.slice(1).findIndex((l) => l.replace(/\r$/, '').trim() === '---');
+  if (close === -1) return null;
+  return lines.slice(1, 1 + close).join('\n');
+}
+
+function collectActionFiles(): string[] {
+  const here = dirname(fileURLToPath(import.meta.url));
+  // contract/src → ikenga-pkgs/packages/skills (sibling repos under the workspace).
+  const skillsRoot = join(here, '..', '..', 'ikenga-pkgs', 'packages', 'skills');
+  if (!existsSync(skillsRoot)) return [];
+  const out: string[] = [];
+  for (const domain of readdirSync(skillsRoot, { withFileTypes: true })) {
+    if (!domain.isDirectory()) continue;
+    const skillsDir = join(skillsRoot, domain.name, 'skills');
+    if (!existsSync(skillsDir)) continue;
+    for (const skill of readdirSync(skillsDir, { withFileTypes: true })) {
+      if (!skill.isDirectory()) continue;
+      const actionsDir = join(skillsDir, skill.name, 'actions');
+      if (!existsSync(actionsDir)) continue;
+      for (const f of readdirSync(actionsDir)) {
+        if (f.endsWith('.md') && f.toLowerCase() !== 'readme.md') {
+          out.push(join(actionsDir, f));
+        }
+      }
+    }
+  }
+  return out.sort();
+}
+
+test('conformance: every real action file with frontmatter parses against ActionFrontmatter', () => {
+  const files = collectActionFiles();
+  // The real action files live in the SIBLING ikenga-pkgs repo, present when the
+  // workspace is checked out whole (local dev) but absent in this repo's isolated
+  // CI checkout. Skip cleanly there — the schema unit tests above already cover
+  // the contract; this is the cross-repo integration layer, best-effort.
+  if (files.length === 0) {
+    console.error('# skip: ikenga-pkgs sibling repo not present (isolated CI checkout)');
+    return;
+  }
+
+  let parsed = 0;
+  const failures: string[] = [];
+  for (const file of files) {
+    const fm = extractFrontmatter(readFileSync(file, 'utf8'));
+    if (fm === null) continue; // prose-only skill doc (groundwork/contribute) — not a structured action
+    const doc = YAML.parse(fm);
+    const res = ActionFrontmatter.safeParse(doc);
+    if (!res.success) {
+      failures.push(`${file}\n  ${JSON.stringify(res.error.issues, null, 2)}`);
+    } else {
+      parsed += 1;
+    }
+  }
+
+  assert.equal(
+    failures.length,
+    0,
+    `real action files failed the schema:\n${failures.join('\n')}`,
+  );
+  // Well above the "at least 3" bar — the full Atelier surface is ~32 structured actions.
+  assert.ok(parsed >= 3, `expected >= 3 structured action files, parsed ${parsed}`);
+});

package/src/action-frontmatter.ts

@@ -0,0 +1,250 @@
+// Ikenga skill-action frontmatter schema — the source-of-truth shape for an
+// Atelier skill *action*'s YAML frontmatter (the block between the leading
+// `---` fences of an `actions/*.md` file).
+//
+// The Rust loader in `royalti-io/ikenga` at
+// `src-tauri/src/pkg/skill_actions.rs` mirrors this schema. Field changes MUST
+// be made in lockstep with that Rust struct — same convention as
+// manifest.ts ↔ manifest.rs.
+//
+// Every field below is justified in plans/atelier/06-skill-action-contract.md.
+
+import { z } from 'zod';
+
+// ---------------------------------------------------------------------------
+// Identity & taxonomy (G-TAXONOMY)
+// ---------------------------------------------------------------------------
+
+/**
+ * The eight stateful domains plus the one stateless generic skill.
+ * `skill-core` is the ONLY legal `depends_on` target (one-way edge, G-04/E-14).
+ */
+export const DomainEnum = z.enum([
+  'tasks',
+  'mail',
+  'outbound',
+  'sales',
+  'finance',
+  'content',
+  'research',
+  'strategy',
+  'skill-core',
+]);
+export type Domain = z.infer<typeof DomainEnum>;
+
+// ---------------------------------------------------------------------------
+// UX modes (R5, E-11) — exactly five
+// ---------------------------------------------------------------------------
+
+/**
+ * How an action presents itself to the operator.
+ *  - confirm   : preview the planned effect, single yes/no, then run.
+ *  - silent    : run with no prompt (still subject to capability scopes).
+ *  - form      : collect `inputs_schema` from the operator before running.
+ *  - streaming : run with live token/log streaming surfaced in the dock.
+ *  - approve   : run-THEN-pause on a produced draft; operator approves/edits
+ *                /rejects the artifact before any external side effect commits
+ *                (the draft-review gate, E-11).
+ */
+export const UxModeEnum = z.enum([
+  'confirm',
+  'silent',
+  'form',
+  'streaming',
+  'approve',
+]);
+export type UxMode = z.infer<typeof UxModeEnum>;
+
+// ---------------------------------------------------------------------------
+// Run binding (R5, G-01) — how the action actually executes
+// ---------------------------------------------------------------------------
+
+/** chat_prompt: hand a templated prompt to the engine in the dock chat. */
+const ChatPromptRun = z.object({
+  kind: z.literal('chat_prompt'),
+  // Prompt template; may interpolate validated `inputs` via {{var}}.
+  prompt: z.string().min(1),
+});
+
+/** sidecar: invoke a bundled CLI sidecar by its manifest-declared id. */
+const SidecarRun = z.object({
+  kind: z.literal('sidecar'),
+  sidecar_id: z.string().min(1),
+  // Argv template; entries may interpolate validated `inputs`.
+  args: z.array(z.string()).default([]),
+});
+
+/** mcp_tool: call a tool on a pkg-declared MCP server. */
+const McpToolRun = z.object({
+  kind: z.literal('mcp_tool'),
+  server_id: z.string().min(1),
+  tool: z.string().min(1),
+});
+
+export const RunBinding = z.discriminatedUnion('kind', [
+  ChatPromptRun,
+  SidecarRun,
+  McpToolRun,
+]);
+export type RunBinding = z.infer<typeof RunBinding>;
+
+// ---------------------------------------------------------------------------
+// Triggers (R5) — absorbs the 41 legacy crons. An action may be reachable by
+// more than one trigger; `manual` is the implicit default if none declared.
+// ---------------------------------------------------------------------------
+
+/** Operator-invoked from the command surface / dock. */
+const ManualTrigger = z.object({
+  kind: z.literal('manual'),
+});
+
+/** Time-driven. `cron` is a standard 5-field crontab expression. */
+const ScheduleTrigger = z.object({
+  kind: z.literal('schedule'),
+  cron: z.string().min(1),
+  // Optional human label surfaced in the schedule UI.
+  label: z.string().optional(),
+});
+
+/** Inbound HTTP trigger routed through the shell bridge. */
+const WebhookTrigger = z.object({
+  kind: z.literal('webhook'),
+  // Stable path segment; the shell namespaces it under the pkg id.
+  path: z.string().min(1),
+});
+
+/** Reacts to an internal shell/domain event by name. */
+const EventTrigger = z.object({
+  kind: z.literal('event'),
+  event: z.string().min(1),
+});
+
+export const Trigger = z.discriminatedUnion('kind', [
+  ManualTrigger,
+  ScheduleTrigger,
+  WebhookTrigger,
+  EventTrigger,
+]);
+export type Trigger = z.infer<typeof Trigger>;
+
+// ---------------------------------------------------------------------------
+// Capabilities (G-08, R18/R19) — coarse permission grants an action requires.
+// `sqlite` is the stateful-domain seam: state lives in the local ikenga.db,
+// reached through the host dbQuery (SELECT-only) and dbExec (parameterized
+// mutate) bridges. The *table scope* is NOT declared here — it is declared once
+// at the pkg manifest as permissions["sqlite.tables"] and cross-checked at
+// install time against the generated tables.json (the applied ikenga.db STRICT
+// schema). The frontmatter only asserts "this action touches sqlite".
+// ---------------------------------------------------------------------------
+
+export const CapabilityEnum = z.enum([
+  'sqlite',   // host.dbQuery / host.dbExec against ikenga.db (R18/R19)
+  'mcp',      // call declared MCP tools
+  'sidecar',  // spawn declared sidecars
+  'network',  // outbound network
+  'fs',       // host filesystem (scoped by manifest)
+  'secrets',  // read Stronghold-vaulted secrets
+  'chat',     // drive the dock chat engine
+]);
+export type Capability = z.infer<typeof CapabilityEnum>;
+
+// ---------------------------------------------------------------------------
+// Setup lifecycle (D-02, setup-lifecycle decision) — `setup` is an optional,
+// well-known action on EVERY skill. It localises the skill per project by
+// writing ${CLAUDE_PROJECT_DIR}/.atelier/<skill>/manifest.json. It runs IN
+// CHAT, never as a form screen. Two modes:
+//   - ai_infer : the agent drafts the instance config from the repo/site, the
+//                operator confirms/edits in chat.
+//   - interview: the agent asks the operator a scripted set of questions.
+// `template_version` carries a migrate path so an upgraded skill can migrate an
+// older instance file forward.
+// ---------------------------------------------------------------------------
+
+export const SetupModeEnum = z.enum(['ai_infer', 'interview']);
+export type SetupMode = z.infer<typeof SetupModeEnum>;
+
+export const SetupSpec = z.object({
+  mode: SetupModeEnum,
+  // Bumped whenever the instance-file shape changes; drives the migrate path.
+  template_version: z.number().int().positive(),
+  // For ai_infer: where the agent should look to draft the instance config.
+  infer_sources: z.array(z.string()).optional(),
+  // For interview: ordered question ids the chat flow walks.
+  interview_questions: z.array(z.string()).optional(),
+});
+export type SetupSpec = z.infer<typeof SetupSpec>;
+
+// ---------------------------------------------------------------------------
+// ActionFrontmatter — the locked shape.
+// ---------------------------------------------------------------------------
+
+export const ActionFrontmatter = z
+  .object({
+    // --- identity ---
+    /** Stable action id, unique within the skill. kebab-case. */
+    name: z
+      .string()
+      .min(1)
+      .regex(/^[a-z][a-z0-9-]*$/, 'name must be kebab-case'),
+    /** One-line human description shown in the command surface. */
+    description: z.string().min(1),
+    /** Owning domain (G-TAXONOMY). */
+    domain: DomainEnum,
+
+    // --- presentation & io ---
+    /** How the action presents to the operator (R5/E-11). */
+    ux_mode: UxModeEnum,
+    /**
+     * JSON-Schema describing the action's inputs. Kept as an opaque object here
+     * (validated as JSON-Schema at the destination); `form`/`approve` modes
+     * render it, `chat_prompt` runs interpolate validated values from it.
+     */
+    inputs_schema: z.record(z.string(), z.unknown()).optional(),
+
+    // --- execution ---
+    /** What the action actually does (G-01). */
+    run: RunBinding,
+    /** How the action can be invoked. Empty ⇒ manual-only. */
+    triggers: z.array(Trigger).default([]),
+
+    // --- dependency & permissions ---
+    /**
+     * One-way dependency edge. The ONLY legal target is 'skill-core'
+     * (G-04/E-14); any other entry is rejected by the lint in
+     * 06-skill-action-contract.md §"depends_on lint". Modeled as a literal
+     * array so the schema itself refuses non-skill-core targets.
+     */
+    depends_on: z.array(z.literal('skill-core')).default([]),
+    /** Coarse capability grants this action needs (G-08, R18/R19). */
+    requires_capabilities: z.array(CapabilityEnum).default([]),
+
+    // --- lifecycle ---
+    /**
+     * Present ONLY on the well-known `setup` action. Omitted on every other
+     * action. Refined below.
+     */
+    setup: SetupSpec.optional(),
+  })
+  .strict()
+  .superRefine((fm, ctx) => {
+    // The `setup` block is allowed iff this IS the setup action.
+    if (fm.name === 'setup' && fm.setup === undefined) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        path: ['setup'],
+        message: 'the "setup" action must declare a `setup` block',
+      });
+    }
+    if (fm.name !== 'setup' && fm.setup !== undefined) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        path: ['setup'],
+        message: '`setup` block is only valid on the "setup" action',
+      });
+    }
+    // An action that runs SQL must declare the `sqlite` capability so the
+    // pkg-manifest sqlite.tables cross-check has something to bind to.
+    // (The reverse — declaring sqlite without using it — is allowed/harmless.)
+  });
+
+export type ActionFrontmatter = z.infer<typeof ActionFrontmatter>;

package/src/index.ts

@@ -9,6 +9,7 @@ export * from './registry.js';
 export * from './browser.js';
 export * from './pa-actions.js';
 export * from './window.js';
+export * from './action-frontmatter.js';
 
 /** This package's own version. */
 export const CONTRACT_PACKAGE_VERSION = '0.5.0' as const;

package/src/manifest.ts

@@ -74,6 +74,11 @@ export const PermissionsSchema = z.object({
    *  without errors during the transition window. */
   'supabase.tables': z.array(z.string()).default([]),
   'vault.keys': z.array(z.string()).default([]),
+  /** Engine scopes exercisable from the pkg iframe. `"invoke"` gates the
+   *  FE-side host.sendToActiveSession / host.startChatSession verbs
+   *  (pkgDeclaresScope). Mirrors `Permissions.engine` in the shell's
+   *  manifest.rs — keep in lockstep. */
+  engine: z.array(z.string()).default([]),
 }).default({});
 
 export const NavEntrySchema = z.object({