skillscript-runtime 0.2.10 → 0.2.12

package/dist/help-content.js

@@ -264,6 +264,44 @@ Skill files open with \`# Key: value\` headers. Order isn't significant.
 \`\`\`
 
 Trigger sources today: \`cron\` (poll-based), \`session\` (\`start\` / \`end\` phases). Parse-only in v0.2: \`event\`, \`agent-event\`, \`file-watch\`, \`sensor\` (firing lands in v1.0).
+
+## Ambient variables (auto-populated by the runtime)
+
+The runtime injects these refs — don't declare them in \`# Vars:\` / \`# Requires:\`.
+
+| Ref | Source | Notes |
+|---|---|---|
+| \`$(NOW)\` | runtime clock | ISO-8601 timestamp at op-dispatch time |
+| \`$(USER)\` | invocation context | Identity passed via \`agentId\` / CLI user |
+| \`$(SESSION_CONTEXT)\` | runtime session | Free-form session snapshot for cross-skill carry |
+| \`$(TRIGGER_TYPE)\` | scheduler | \`cron\` / \`session\` / \`manual\` / \`agent-event\` |
+| \`$(TRIGGER_PAYLOAD)\` | scheduler | JSON-serializable payload attached to the firing trigger |
+| \`$(ERROR_CONTEXT)\` | runtime error handler | Inside \`else:\` and \`# OnError:\` only; \`.kind\` / \`.message\` / \`.target\` accessible |
+
+\`EVENT.*\` auto-populates on cron-fired skills (v0.2.7 scheduler):
+
+| Ref | Value |
+|---|---|
+| \`$(EVENT.fired_at)\` | epoch milliseconds |
+| \`$(EVENT.fired_at_unix)\` | epoch seconds |
+| \`$(EVENT.fired_at_plus_1h_unix)\` | \`fired_at_unix + 3600\` |
+| \`$(EVENT.fired_at_plus_1d_unix)\` | \`fired_at_unix + 86_400\` |
+| \`$(EVENT.fired_at_plus_7d_unix)\` | \`fired_at_unix + 604_800\` |
+
+(v0.2.12 Bug 24 — \`EVENT.*\` was undocumented before this release.)
+
+## Variable reference forms
+
+\`\`\`
+$(VAR)              bare ref (any declared/output-bound/ambient name)
+$(VAR.field)        dotted field access on JSON-bound vars + ambient family
+$(LIST.0)           indexed access (v0.2.12 Bug 25 — was undocumented)
+$(LIST.0.id)        mixed indexed + field-access (chains arbitrarily deep)
+$(VAR|filter)       filter pipe (see \`help({topic: "ops"})\` for filter list)
+$(VAR.field|filter) field-access then filter
+\`\`\`
+
+Unresolved refs: tier-1 \`undeclared-var\` at compile, \`UnresolvedVariableError\` at runtime.
 `;
 const EXAMPLES = `# Three canonical worked skills
 
@@ -335,6 +373,93 @@ default: route
 \`\`\`
 
 Demonstrates: \`~\` LocalModel op, named model selection, \`|trim\` filter on LLM output, ref-vs-literal comparison, agent delivery via \`prompt-context:\`, augmenting headers (\`# Delivery-context:\` + \`# Templates:\`).
+
+## 4. Composition — orchestrator invoking child skills
+
+\`\`\`
+# Skill: morning-brief-orchestrator
+# Description: Fan out to three child skills, gather their outputs into one brief.
+# Status: Approved
+# Vars: USER_NAME=Scott
+
+gather:
+    $ execute_skill skill_name=calendar-today USER=$(USER_NAME) -> CAL (fallback: "(no calendar data)")
+    $ execute_skill skill_name=mailbox-triage USER=$(USER_NAME) -> MAIL (fallback: "(mailbox empty)")
+    $ execute_skill skill_name=weather-summary -> WX (fallback: "(weather unavailable)")
+
+render: gather
+    ! Good morning, $(USER_NAME). Today:
+    ! • Calendar: $(CAL)
+    ! • Mailbox: $(MAIL)
+    ! • Weather: $(WX)
+
+default: render
+\`\`\`
+
+Demonstrates: in-skill \`$ execute_skill\` composition (each child runs through the runtime under a depth-counted chain), per-call \`(fallback: ...)\` for resilience, kwarg forwarding (\`USER=$(USER_NAME)\`), \`->\` binding child output for downstream reference.
+`;
+const COMPOSITION = `# Composition
+
+Skillscript has three composition primitives — all let one skill draw on another's output, with different semantics around when, where, and how the child runs.
+
+## 1. \`& <skill-name>\` — data-skill inline (compile-time)
+
+Inlines an *Approved data skill* into the host skill's compiled artifact at the call site. The data skill's body becomes part of the rendered prompt. Use for *static* knowledge or templated content (style guides, voice rules, runbooks).
+
+\`\`\`
+brief:
+    ~ prompt="$(VOICE_RULES) Now write a one-line status:" model=qwen -> RESULT
+    & voice-rules
+\`\`\`
+
+- Resolved at \`compile()\` time — the data skill's \`content_hash\` is recorded in the host's provenance block.
+- Provenance lets \`skillfile audit\` detect stale recompiles when a referenced data skill changes.
+- The data skill must be marked \`# Skill-kind: data\` (or live in a path the SkillStore recognizes as data); otherwise it's treated as procedural and won't inline.
+
+## 2. \`& invoke <skill-name>\` — runtime call (per-fire)
+
+Calls a procedural skill at runtime. Each call goes through the runtime under a depth-counted chain (default limit 5) — same recursion guard as Style 3 below.
+
+\`\`\`
+escalate:
+    & invoke notify-oncall
+\`\`\`
+
+- Child skill's outputs flow into the parent's variable scope.
+- Failures propagate as \`OpError\`s.
+
+## 3. \`$ execute_skill skill_name="<child>" ...kwargs -> VAR\` — in-skill execute (per-fire)
+
+The most general form: the host \`$\`-dispatches the literal tool name \`execute_skill\` (intercepted by the runtime, not sent to any MCP server). Same depth-counted chain as Style 2, plus full kwarg forwarding and \`-> VAR\` binding for downstream use.
+
+\`\`\`
+gather:
+    $ execute_skill skill_name="calendar-today" USER=$(USER_NAME) -> CAL (fallback: "(no calendar data)")
+    $ execute_skill skill_name="mailbox-triage" inputs={"USER": "$(USER_NAME)"} -> MAIL
+\`\`\`
+
+Two kwarg styles, both supported (v0.2.9 fix):
+- **Bare kwargs** — \`USER=$(USER_NAME)\` natural skill grammar
+- **\`inputs={...}\` JSON** — MCP-call parity, useful when forwarding many fields verbatim
+
+The bound \`-> VAR\` carries the child's final emit through to the host's scope.
+
+## Limits & lint signals
+
+- **Recursion**: depth-5 chain by default (\`ExecuteSkillRecursionError\` if exceeded). Both \`& invoke\` and \`$ execute_skill\` share the counter.
+- **Lint** (\`unknown-skill-reference\`, tier-1): \`& <name>\`, \`& invoke <name>\`, and \`$ execute_skill skill_name=<name>\` all validate the child skill exists in the SkillStore at compile time (v0.2.11 Bug 7 closed the \`$ execute_skill\` gap).
+- **Lint** (\`disabled-skill-reference\`, tier-1): any composition primitive pointing at a \`# Status: Disabled\` skill blocks compile.
+
+## When to use which
+
+| Use case | Primitive |
+|---|---|
+| Static knowledge in a prompt | \`& <data-skill>\` |
+| Fire-and-forget child call | \`& invoke <skill>\` |
+| Child output bound into parent scope | \`$ execute_skill ... -> VAR\` |
+| Parallel orchestrators (v0.3.0 candidate — not yet shipped) | parked |
+
+See \`help({topic: "examples"})\` example 4 for a worked orchestrator skill.
 `;
 const CONNECTORS_PROLOGUE = `# Connectors
 
@@ -385,19 +510,22 @@ Three tiers per ERD §3:
 - \`single-equals\` — \`if $(VAR) = "..."\` instead of \`==\` (specific diagnostic)
 - \`indentation\` — tabs in indentation; mixed tabs/spaces
 - \`reserved-keyword\` — variable/target/skill name collides with a reserved word
-- \`unknown-skill-reference\` — \`&\` op references a skill not in the store
-- \`disabled-skill-reference\` — \`&\` op references a Disabled skill
+- \`unknown-skill-reference\` — \`&\` or \`$ execute_skill\` references a skill not in the store (v0.2.11 Bug 7 extended to cover \`$ execute_skill\`)
+- \`unknown-template-reference\` — \`# Templates: <name>\` references a skill not in the store (v0.2.12 Bug 17)
+- \`disabled-skill-reference\` — \`&\` or \`$ execute_skill\` references a Disabled skill
 - \`credential-in-args\` — op arg looks like a secret literal
 - \`status-disabled\` — skill marked \`# Status: Disabled\`
 - \`circular-dependency\` — dep cycle between targets
 - \`missing-dependency\` — \`needs:\` references a target not declared
 - \`missing-skillstore-for-data-ref\` — \`&\` op fires without a SkillStore wired
+- \`unsafe-shell-disabled\` — \`@ unsafe\` declared but \`enableUnsafeShell: false\` (v0.2.11 Bug 5; fires only when caller passes the flag explicitly false)
 
 ## Tier-2 (warning)
 
 - \`deprecated-question\` — bare \`?\` op (deprecated v1; compile-error in v1.x)
 - \`unsafe-shell-ambiguous-subst\` — \`$(NAME)\` inside \`@ unsafe\` body that isn't a declared variable; collides with bash command-sub syntax
 - \`unsafe-shell-op\` — \`@ unsafe\` op present; requires human review every time
+- \`unknown-retrieval-arg\` — \`>\` op carries kwargs outside mode/query/limit/connector/fallback (v0.2.12 Bug 26)
 - \`unconfirmed-mutation\` — \`$\` op invokes a tool whose name suggests mutation (write/update/delete) without a preceding \`??\` confirmation
 - \`model-contention\` — async + sync ops on the same model serialize on a single runtime worker
 - \`draft-with-trigger\` — \`# Status: Draft\` skill has \`# Triggers:\` declared; triggers won't fire until Approved
@@ -420,7 +548,7 @@ export function helpResponse(topic, runtimeVersion, registry) {
             topic: null,
             version: runtimeVersion,
             content: QUICKSTART,
-            available_topics: ["ops", "frontmatter", "examples", "connectors", "lint-codes"],
+            available_topics: ["ops", "frontmatter", "examples", "composition", "connectors", "lint-codes"],
         };
     }
     let content;
@@ -434,6 +562,9 @@ export function helpResponse(topic, runtimeVersion, registry) {
         case "examples":
             content = EXAMPLES;
             break;
+        case "composition":
+            content = COMPOSITION;
+            break;
         case "connectors":
             content = renderConnectorsTopic(registry);
             break;
@@ -441,7 +572,7 @@ export function helpResponse(topic, runtimeVersion, registry) {
             content = LINT_CODES;
             break;
         default:
-            content = `# Unknown topic '${topic}'\n\nValid topics: ops, frontmatter, examples, connectors, lint-codes`;
+            content = `# Unknown topic '${topic}'\n\nValid topics: ops, frontmatter, examples, composition, connectors, lint-codes`;
     }
     return { topic, version: runtimeVersion, content };
 }

package/dist/help-content.js.map

@@ -1 +1 @@
-{"version":3,"file":"help-content.js","sourceRoot":"","sources":["../src/help-content.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"help-content.js","sourceRoot":"","sources":["../src/help-content.ts"],"names":[],"mappings":"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"}

package/dist/lint.d.ts

@@ -69,6 +69,15 @@ export interface LintOptions {
      * preflight). Default `"api"`.
      */
     callSite?: "cli" | "api" | "compile-preflight";
+    /**
+     * Runtime `enableUnsafeShell` flag, if known to the caller. When
+     * explicitly `false`, the `unsafe-shell-disabled` rule (v0.2.11 Bug 5)
+     * fires tier-1 on any `@ unsafe` op — the skill would refuse at
+     * runtime, and compile should surface that up-front. When `undefined`
+     * (caller doesn't know), only the standard tier-2 `unsafe-shell-op`
+     * warning fires.
+     */
+    enableUnsafeShell?: boolean;
 }
 interface LintContext {
     parsed: ParsedSkill;
@@ -78,6 +87,7 @@ interface LintContext {
     skillStore: SkillStore | undefined;
     hasSkillStore: boolean;
     callSite: "cli" | "api" | "compile-preflight";
+    enableUnsafeShell: boolean | undefined;
 }
 export interface LintRule {
     id: string;

package/dist/lint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../src/lint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,WAAW,EAAgB,MAAM,aAAa,CAAC;AAEpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,kBAAkB,IAAI,kBAAkB,CAAA;KAAE,CAAC,CAAC;IAC9D,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,mBAAmB,CAAC;CAChD;AAED,UAAU,WAAW;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,iBAAiB,EAAE,KAAK,CAAC;QAAE,kBAAkB,IAAI,kBAAkB,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;IAC9E,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;IACnC,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,mBAAmB,CAAC;CAC/C;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAChE,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAgCrF;AAED,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,UAAU,CA+B1E;AAED,6HAA6H;AAC7H,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAW3D;AAsyBD,mFAAmF;AACnF,wBAAgB,SAAS,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAElE"}
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../src/lint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,WAAW,EAAgB,MAAM,aAAa,CAAC;AAEpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,kBAAkB,IAAI,kBAAkB,CAAA;KAAE,CAAC,CAAC;IAC9D,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,mBAAmB,CAAC;IAC/C;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,UAAU,WAAW;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,iBAAiB,EAAE,KAAK,CAAC;QAAE,kBAAkB,IAAI,kBAAkB,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;IAC9E,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;IACnC,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,mBAAmB,CAAC;IAC9C,iBAAiB,EAAE,OAAO,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAChE,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAiCrF;AAED,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,UAAU,CAgC1E;AAED,6HAA6H;AAC7H,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAW3D;AAk6BD,mFAAmF;AACnF,wBAAgB,SAAS,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAElE"}

package/dist/lint.js

@@ -9,6 +9,7 @@ export async function lint(source, options) {
         skillStore: options?.skillStore,
         hasSkillStore: options?.skillStore !== undefined,
         callSite: options?.callSite ?? "api",
+        enableUnsafeShell: options?.enableUnsafeShell,
     };
     const findings = [];
     for (const rule of RULES) {
@@ -41,6 +42,7 @@ export function lintSync(source, options) {
         skillStore: options?.skillStore,
         hasSkillStore: options?.skillStore !== undefined,
         callSite: options?.callSite ?? "api",
+        enableUnsafeShell: options?.enableUnsafeShell,
     };
     const findings = [];
     for (const rule of RULES) {
@@ -364,20 +366,21 @@ const UNKNOWN_SKILL_REFERENCE = {
         const findings = [];
         const seen = new Set();
         for (const [targetName, target] of ctx.parsed.targets) {
-            for (const refName of collectAmpRefsFromOps(target.ops)) {
-                if (seen.has(refName))
+            for (const ref of collectAmpRefsFromOps(target.ops)) {
+                const key = `${ref.via}:${ref.name}`;
+                if (seen.has(key))
                     continue;
-                seen.add(refName);
+                seen.add(key);
                 try {
-                    await ctx.skillStore.metadata(refName);
+                    await ctx.skillStore.metadata(ref.name);
                 }
                 catch {
                     findings.push({
                         rule: "unknown-skill-reference",
                         severity: "error",
-                        message: `Skill '${targetName}' references skill '${refName}' via \`&\`, but the SkillStore has no skill by that name.`,
+                        message: `Skill '${targetName}' references skill '${ref.name}' via \`${ref.via}\`, but the SkillStore has no skill by that name.`,
                         block: targetName,
-                        extras: { referenced_skill: refName },
+                        extras: { referenced_skill: ref.name, via: ref.via },
                     });
                 }
             }
@@ -385,6 +388,70 @@ const UNKNOWN_SKILL_REFERENCE = {
         return findings;
     },
 };
+// v0.2.12 Bug 26. Tier-2 warning when a `>` retrieval op carries kwargs
+// outside the documented set. Cold author wrote `since=1h` (hallucinated
+// time-window predicate) and the kwarg passed silently. The documented
+// kwarg set is mode/query/limit/connector/fallback plus filter shapes
+// the connector advertises via staticCapabilities (out of band here).
+const KNOWN_RETRIEVAL_KWARGS = new Set(["mode", "query", "limit", "connector", "fallback"]);
+const UNKNOWN_RETRIEVAL_ARG = {
+    id: "unknown-retrieval-arg",
+    severity: "warning",
+    description: "A `>` retrieval op carries a kwarg outside the documented set (mode/query/limit/connector/fallback).",
+    remediation: "Remove the kwarg, or check it against your MemoryStore connector's documentation — extras pass through to the connector but unrecognized ones often indicate hallucinated syntax.",
+    check: (ctx) => {
+        const findings = [];
+        for (const [targetName, target] of ctx.parsed.targets) {
+            walkOps(target.ops, (op) => {
+                if (op.kind !== ">")
+                    return;
+                const extras = op.retrievalParams?.extra ?? {};
+                for (const k of Object.keys(extras)) {
+                    if (KNOWN_RETRIEVAL_KWARGS.has(k))
+                        continue;
+                    findings.push({
+                        rule: "unknown-retrieval-arg",
+                        severity: "warning",
+                        message: `\`>\` op in target '${targetName}' carries unknown kwarg '${k}'. Documented kwargs: ${Array.from(KNOWN_RETRIEVAL_KWARGS).join(", ")}. If '${k}' is a connector-specific filter, confirm it against the connector's docs.`,
+                        block: targetName,
+                        extras: { unknown_kwarg: k },
+                    });
+                }
+            });
+        }
+        return findings;
+    },
+};
+// v0.2.12 Bug 17. `# Templates:` refs were not lint-validated despite
+// `# OnError:` having compile-time validation (since v0.2.10). Tier-1
+// because a missing template fails delivery at runtime.
+const UNKNOWN_TEMPLATE_REFERENCE = {
+    id: "unknown-template-reference",
+    severity: "error",
+    description: "`# Templates: <name>` references a skill that's not present in the configured SkillStore.",
+    remediation: "Check the template name spelling, or store the missing template skill before referencing it. Templates resolve at delivery time; missing ones fail the agent delivery.",
+    check: async (ctx) => {
+        if (ctx.skillStore === undefined)
+            return [];
+        if (ctx.parsed.templates.length === 0)
+            return [];
+        const findings = [];
+        for (const name of ctx.parsed.templates) {
+            try {
+                await ctx.skillStore.metadata(name);
+            }
+            catch {
+                findings.push({
+                    rule: "unknown-template-reference",
+                    severity: "error",
+                    message: `Skill references template '${name}' via \`# Templates:\`, but the SkillStore has no skill by that name.`,
+                    extras: { referenced_skill: name },
+                });
+            }
+        }
+        return findings;
+    },
+};
 const DISABLED_SKILL_REFERENCE = {
     id: "disabled-skill-reference",
     severity: "error",
@@ -396,19 +463,19 @@ const DISABLED_SKILL_REFERENCE = {
         const findings = [];
         const checked = new Set();
         for (const [targetName, target] of ctx.parsed.targets) {
-            for (const refName of collectAmpRefsFromOps(target.ops)) {
-                if (checked.has(refName))
+            for (const ref of collectAmpRefsFromOps(target.ops)) {
+                if (checked.has(ref.name))
                     continue;
-                checked.add(refName);
+                checked.add(ref.name);
                 try {
-                    const meta = await ctx.skillStore.metadata(refName);
+                    const meta = await ctx.skillStore.metadata(ref.name);
                     if (meta.status === "Disabled") {
                         findings.push({
                             rule: "disabled-skill-reference",
                             severity: "error",
-                            message: `Skill '${targetName}' references '${refName}' which is disabled.`,
+                            message: `Skill '${targetName}' references '${ref.name}' via \`${ref.via}\` which is disabled.`,
                             block: targetName,
-                            extras: { referenced_skill: refName, target_status: meta.status },
+                            extras: { referenced_skill: ref.name, via: ref.via, target_status: meta.status },
                         });
                     }
                 }
@@ -627,6 +694,19 @@ const UNSAFE_SHELL_AMBIGUOUS_SUBST = {
                     const trimmed = inner.trim();
                     if (/^[A-Za-z_]\w*$/.test(trimmed) && declared.has(trimmed))
                         continue;
+                    // v0.2.11 Bug 4: dotted refs (EVENT.fired_at_unix, MEMORY.x,
+                    // <target>.output) are runtime ambient/output families — same
+                    // dotted-passthrough heuristic as `undeclared-var`. The
+                    // unsafe-shell warning was telling cold authors to rewrite
+                    // `$(EVENT.fired_at_unix)` as `$$(EVENT.fired_at_unix)` (bash
+                    // command-sub), which would just try to execute "EVENT...".
+                    if (trimmed.includes("."))
+                        continue;
+                    // v0.2.11 Bug 4: bare ambient refs (NOW, USER, ERROR_CONTEXT,
+                    // SESSION_CONTEXT, TRIGGER_TYPE, TRIGGER_PAYLOAD) also pass —
+                    // runtime injects them, author doesn't declare.
+                    if (AMBIENT_VARS.includes(trimmed))
+                        continue;
                     if (reported.has(inner))
                         continue;
                     reported.add(inner);
@@ -665,8 +745,55 @@ const UNSAFE_SHELL_OP = {
         return findings;
     },
 };
-/** Tool-name patterns that strongly suggest mutating operations. Conservative — false positives are tolerable for warnings; false negatives are dangerous. */
-const MUTATING_TOOL_PATTERN = /^(?:write_|update_|delete_|remove_|set_|create_|insert_|put_|patch_|destroy_).*/;
+/**
+ * v0.2.11 Bug 5. Tier-1 escalation of the unsafe-shell signal — only
+ * fires when the caller passed `enableUnsafeShell: false` explicitly.
+ * Without that knowledge (the field is undefined), this rule stays
+ * silent and the tier-2 `unsafe-shell-op` warning is the only signal.
+ *
+ * When the runtime is known-disabled, every `@ unsafe` op is a guaranteed
+ * runtime refusal (`UnsafeShellDisabledError`). Surfacing that at compile
+ * time instead of letting the skill compile clean and then fail at first
+ * fire avoids the "compiles clean but won't run" gap Perry's harness
+ * surfaced (memory `b6176e02`).
+ */
+const UNSAFE_SHELL_DISABLED = {
+    id: "unsafe-shell-disabled",
+    severity: "error",
+    description: "Skill uses `@ unsafe`, but the runtime was configured with `enableUnsafeShell: false`. The op will refuse at first fire.",
+    remediation: "Either set `enableUnsafeShell: true` on the runtime (after reviewing the shell content), or refactor the `@ unsafe` op to use the structured `@ <binary> <args>` form (sandboxed, no bash).",
+    check: (ctx) => {
+        if (ctx.enableUnsafeShell !== false)
+            return [];
+        const findings = [];
+        for (const [targetName, target] of ctx.parsed.targets) {
+            walkOps(target.ops, (op) => {
+                if (op.kind === "@" && op.policy === "unsafe") {
+                    findings.push({
+                        rule: "unsafe-shell-disabled",
+                        severity: "error",
+                        message: `\`@ unsafe\` op in target '${targetName}' would refuse at runtime: \`enableUnsafeShell\` is false. Command: '${op.body.slice(0, 60)}${op.body.length > 60 ? "..." : ""}'`,
+                        block: targetName,
+                    });
+                }
+            });
+        }
+        return findings;
+    },
+};
+/**
+ * Tool-name patterns that strongly suggest mutating operations.
+ * Conservative — false positives are tolerable for warnings; false
+ * negatives are dangerous.
+ *
+ * v0.2.11 Bug 6: extended with archive_/prune_/deploy_/expire_/
+ * consolidate_/purge_/reset_/rotate_/move_/rename_/drop_/truncate_/
+ * upsert_/overwrite_/clear_/wipe_/finalize_ — Perry's wild-and-crazy
+ * harness surfaced a cluster of mutating tools that the original
+ * write/update/delete/etc. set didn't catch (`archive_old_threads`,
+ * `prune_threads`, `deploy_release`, `dangerous-cleanup`'s `expire_*`).
+ */
+const MUTATING_TOOL_PATTERN = /^(?:write_|update_|delete_|remove_|set_|create_|insert_|put_|patch_|destroy_|archive_|prune_|deploy_|expire_|consolidate_|purge_|reset_|rotate_|move_|rename_|drop_|truncate_|upsert_|overwrite_|clear_|wipe_|finalize_).*/;
 const UNCONFIRMED_MUTATION = {
     id: "unconfirmed-mutation",
     severity: "warning",
@@ -756,19 +883,19 @@ const REFERENCE_TO_DISABLED_SKILL = {
         const findings = [];
         const checked = new Set();
         for (const [targetName, target] of ctx.parsed.targets) {
-            for (const refName of collectAmpRefsFromOps(target.ops)) {
-                if (checked.has(refName))
+            for (const ref of collectAmpRefsFromOps(target.ops)) {
+                if (checked.has(ref.name))
                     continue;
-                checked.add(refName);
+                checked.add(ref.name);
                 try {
-                    const meta = await ctx.skillStore.metadata(refName);
+                    const meta = await ctx.skillStore.metadata(ref.name);
                     if (meta.status === "Disabled") {
                         findings.push({
                             rule: "reference-to-disabled-skill",
                             severity: "warning",
-                            message: `Target '${targetName}' references '${refName}' which is disabled.`,
+                            message: `Target '${targetName}' references '${ref.name}' via \`${ref.via}\` which is disabled.`,
                             block: targetName,
-                            extras: { referenced_skill: refName },
+                            extras: { referenced_skill: ref.name, via: ref.via },
                         });
                     }
                 }
@@ -872,6 +999,8 @@ const RULES = [
     INDENTATION,
     RESERVED_KEYWORD,
     UNKNOWN_SKILL_REFERENCE,
+    UNKNOWN_TEMPLATE_REFERENCE,
+    UNKNOWN_RETRIEVAL_ARG,
     DISABLED_SKILL_REFERENCE,
     CREDENTIAL_IN_ARGS,
     STATUS_DISABLED,
@@ -882,6 +1011,7 @@ const RULES = [
     DEPRECATED_QUESTION,
     UNSAFE_SHELL_AMBIGUOUS_SUBST,
     UNSAFE_SHELL_OP,
+    UNSAFE_SHELL_DISABLED,
     UNCONFIRMED_MUTATION,
     MODEL_CONTENTION,
     DRAFT_WITH_TRIGGER,
@@ -911,10 +1041,27 @@ function walkOps(ops, visit) {
     }
 }
 function collectAmpRefsFromOps(ops) {
-    const out = new Set();
+    const out = [];
+    const seen = new Set();
+    const emit = (name, via) => {
+        const key = `${via}:${name}`;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        out.push({ name, via });
+    };
     walkOps(ops, (op) => {
         if (op.kind === "&" && op.ampParams !== undefined)
-            out.add(op.ampParams.skillName);
+            emit(op.ampParams.skillName, "&");
+        // v0.2.11 Bug 7: $ execute_skill is also a composition primitive.
+        if (op.kind === "$" && /^execute_skill\b/.test(op.body)) {
+            const m = /\bskill_name\s*=\s*(?:"([^"]+)"|'([^']+)'|([A-Za-z_][\w-]*))/.exec(op.body);
+            if (m !== null) {
+                const name = m[1] ?? m[2] ?? m[3];
+                if (name !== undefined && name !== "")
+                    emit(name, "$ execute_skill");
+            }
+        }
     });
     return out;
 }