opensquid 0.5.395

package/dist/packs/schemas/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../src/packs/schemas/skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwExB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;EAYtB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAgBtD,eAAO,MAAM,YAAY,iDAA+C,CAAC;AACzE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAcxD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYzB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAsB5D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM/B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAoBxE,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAchB,CAAC;AACF,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAmCxC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,+JAAY,CAAC;AACrC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAWtD,eAAO,MAAM,YAAY,gCAA8B,CAAC;AACxD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AASxD,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BhB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC"}

package/dist/packs/schemas/skill.js

@@ -0,0 +1,292 @@
+/**
+ * Zod schema for `skill.yaml` — one skill's definition inside a pack.
+ *
+ * Authoritative source: `docs/opensquid-real-design.md` §"Skill format" +
+ * §"Skill properties" + memory `project_opensquid_modular_function_skill_separation`
+ * + `project_opensquid_pack_load_hybrid`.
+ *
+ * A skill is a unit of work-discipline that loads + unloads dynamically based
+ * on declared conditions. Rules inside the skill express checks as PROCESSES
+ * — compositions of primitive function calls — not as enumerated typed unions.
+ * This keeps the schema small while staying expressive.
+ *
+ * NOT `.strict()`: skills are extended over time (Phase 3 refines
+ * `when_to_load` matchers; future phases may add fields). We accept extra keys
+ * at load time and let higher layers (rule evaluator, matcher) decide whether
+ * an unknown field is meaningful or noise. Manifest is the only file where
+ * `.strict()` makes sense — pack identity must not silently typo.
+ *
+ * `when_to_load` is refined to a `Matcher` discriminated union (Phase 3 Task
+ * 3.1) and `unloads_when` to an `UnloadCondition` discriminated union (Phase
+ * 3 Task 3.2). Pack authors can use shorthand forms — single-key objects
+ * (`- tool_match: Bash`) and bare strings (`- session_ends`) — the schemas'
+ * preprocess hooks normalize both to canonical discriminated form.
+ *
+ * Imports from: zod, ../../runtime/load_matchers, ../../runtime/unload_conditions.
+ * Imported by: src/packs/schemas/index.ts.
+ */
+import { z } from 'zod';
+import { parseExpression } from '../../runtime/evaluator/expression/index.js';
+import { Matcher } from '../../runtime/load_matchers.js';
+import { SkillRequires } from '../../runtime/skill_requires.js';
+import { EventKind, Trigger, defaultTriggers } from '../../runtime/types.js';
+import { UnloadCondition } from '../../runtime/unload_conditions.js';
+// ---------------------------------------------------------------------------
+// conditionString — load-time-validated `if:` expression (Task H.2).
+//
+// Wraps `z.string()` with a `.refine()` that parses the expression through
+// `parseExpression` (chevrotain lexer + parser + AST visitor from H.1). A
+// pack with an unparseable `if:` clause now fails fast at `loadPack()` with
+// full source-path + Zod field-path context — was previously a silent
+// `false` + `console.warn` at first event fire.
+//
+// Empty / whitespace-only strings are accepted at load time (return true)
+// to match the runtime's §12.2 semantics in
+// `src/runtime/evaluator/expression/index.ts:82` — a present-but-empty
+// `if:` is equivalent to "no `if:` field" so trailing-whitespace YAML
+// doesn't accidentally skip steps. The `parseExpression` entry itself
+// throws on empties (it's the parse-only sibling — see its JSDoc); we
+// short-circuit before calling it.
+//
+// Error threading: `parseYamlFile` (src/packs/yaml.ts:86–93) wraps Zod's
+// `.message` with the source path, producing the final shape:
+//
+//   "Schema validation failed for skills/foo/skill.yaml:
+//    process[2].if: invalid if: expression — see docs/skill-grammar-guide.md"
+//
+// No changes needed to `loader.ts` or `yaml.ts` — pre-research §8.1
+// verified the existing formatter threads paths + field positions cleanly.
+//
+// Perf: each refinement runs lex+parse+ast (no cache hit here — the cache
+// in `evaluator/expression/cache.ts` is for `evalCondition` reads). Pre-
+// research §8.1 estimated ~30ms for a 100-skill pack with avg 3 `if:`
+// clauses each (300 invocations × ~0.1ms grammar). Runs once per process
+// start; acceptable.
+// ---------------------------------------------------------------------------
+const conditionString = z.string().refine((s) => {
+    if (s.trim() === '')
+        return true;
+    try {
+        parseExpression(s);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}, { message: 'invalid if: expression — see docs/skill-grammar-guide.md' });
+// ---------------------------------------------------------------------------
+// ProcessStep — one step inside a rule's process.
+//
+// `call` — the primitive function name (regex_match, llm_classify, verdict,
+//          recall, store_lesson, etc.).
+// `args` — opaque key-value bag; per-primitive Zod refinement lands in the
+//          function-library registry (separate from this YAML schema).
+// `as`   — variable binding for downstream steps (`as: hit` then `if: hit`).
+// `if`   — conditional execution expression (evaluator-interpreted). Wrapped
+//          in `conditionString` for load-time grammar validation (H.2).
+// `on_empty` — what verdict to emit when the call produces no output.
+//
+// Note: a second `ProcessStep` schema lives at `src/runtime/types.ts:93–99`
+// with a loose `if: z.string().optional()`. The YAML load path goes through
+// THIS schema (the load-time validation entry point); de-duplication is a
+// separate cleanup task (out of scope for H.2).
+// ---------------------------------------------------------------------------
+export const ProcessStep = z.object({
+    call: z.string().min(1),
+    args: z.record(z.unknown()).optional(),
+    as: z.string().optional(),
+    if: conditionString.optional(),
+    on_empty: z.enum(['pass', 'block', 'continue']).optional(),
+    // on_error — failure-side twin of on_empty. Absent / 'abort' (default) →
+    // the evaluator returns kind:'error' (hard-abort). 'continue' → the error
+    // message binds to `as` and the process proceeds, so a rule can branch on a
+    // failed step (e.g. an audit subagent that could not spawn). Mirror of the
+    // runtime schema at src/runtime/types.ts.
+    on_error: z.enum(['abort', 'continue']).optional(),
+});
+// ---------------------------------------------------------------------------
+// RuleKindEnum — two anti-drift flavors per design doc §"Anti-drift split".
+//
+// `track_check`       — deterministic workflow rule (regex, count, sequence).
+// `destination_check` — LLM-judged goal-alignment check via model alias.
+// Default: track_check (the more common case).
+//
+// Phase 4 splits the formerly-flat `Rule` schema into a discriminated union on
+// `kind` so each flavor carries only the fields it actually uses
+// (track_check has `process`, destination_check has `interval` +
+// `model_alias` + `prompt_template`). The enum is kept as a public re-export
+// for callers that want the union-of-literal-strings as a single type.
+// ---------------------------------------------------------------------------
+export const RuleKindEnum = z.enum(['track_check', 'destination_check']);
+// ---------------------------------------------------------------------------
+// TrackCheckRule — deterministic workflow rule.
+//
+// `kind` keeps its `.default('track_check')` so existing pack YAML that omits
+// the field (the Phase 1–3 common case) continues to parse. Combined with the
+// `Rule`-level preprocess (below), pack authors can author a rule without any
+// `kind:` field at all and still land in this branch.
+//
+// `process` is required (`min(1)`): a track_check with no steps is a no-op
+// that would silently never fire — almost always a YAML mistake.
+// ---------------------------------------------------------------------------
+export const TrackCheckRule = z.object({
+    id: z.string().min(1),
+    kind: z.literal('track_check').default('track_check'),
+    // T-ASC ASC.5: per-rule AND-preconditions evaluated at the dispatcher
+    // boundary AFTER skill.requires and BEFORE walking the process. Each entry
+    // is a SkillRequires discriminated-union variant. Empty array trivially
+    // holds (back-compat). Per-rule requires support different chain_stage
+    // values across rules in the same skill (the skill-level requires is one
+    // condition shared across all the skill's rules; per-rule is the natural
+    // place for stage-specific gating).
+    requires: z.array(SkillRequires).default([]),
+    process: z.array(ProcessStep).min(1),
+});
+// ---------------------------------------------------------------------------
+// DestinationCheckRule — LLM-judged goal-alignment check.
+//
+// `interval`         — required. Periodic firing cadence (per N tool calls).
+//                      The scheduler (Task 4.3) reads this and counts events.
+// `model_alias`      — defaults to `'reasoning'` (cheapest model-neutral
+//                      label for a judgement call; user maps to a concrete
+//                      backend in `models.yaml`).
+// `prompt_template`  — required string. Pack-authored prompt. Empty string
+//                      parses (loosest validation) but the runtime primitive
+//                      (Task 4.2) surfaces it on first invoke; we deliberately
+//                      let typos through so the failure mode is loud at runtime
+//                      rather than silently rejected at load.
+//
+// Note: no `process` field — destination_check fires through a dedicated
+// primitive (`check_destination`), not the generic process evaluator. Adding
+// `process` here would be a footgun (pack authors would mix `process` with
+// `prompt_template` and expect both to do something).
+// ---------------------------------------------------------------------------
+export const DestinationCheckRule = z.object({
+    id: z.string().min(1),
+    kind: z.literal('destination_check'),
+    interval: z.object({ every_n_tool_calls: z.number().int().positive() }),
+    model_alias: z.string().default('reasoning'),
+    prompt_template: z.string(),
+});
+// ---------------------------------------------------------------------------
+// Rule — discriminated union on `kind`.
+//
+// `z.discriminatedUnion` is strict about presence: it requires the discriminant
+// field to be a literal string. That collides with the Phase 1–3 convention
+// where pack authors author track_check rules without writing `kind:` at all
+// (defaulting to track_check). We compensate via a `z.preprocess` shim that
+// fills in `kind: 'track_check'` when missing, BEFORE the discriminated union
+// runs. The shim is a no-op for any input that already declares `kind`, so
+// destination_check rules pass through unchanged.
+//
+// The preprocess input is `unknown` (not a typed object) because Zod's
+// discriminated-union signature accepts `unknown` and any narrower type would
+// reject legitimate YAML shapes (e.g. arrays accidentally placed where an
+// object should be — we want those to surface as proper Zod errors, not type
+// crashes inside the shim).
+// ---------------------------------------------------------------------------
+export const Rule = z.preprocess((input) => {
+    if (typeof input !== 'object' || input === null || Array.isArray(input)) {
+        // Non-object input — pass through so the discriminated union rejects with
+        // a sensible "expected object" error instead of throwing in the shim.
+        return input;
+    }
+    const obj = input;
+    if (obj.kind === undefined) {
+        return { ...obj, kind: 'track_check' };
+    }
+    return obj;
+}, z.discriminatedUnion('kind', [TrackCheckRule, DestinationCheckRule]));
+// ---------------------------------------------------------------------------
+// Trigger — which Event kinds fire this skill (AUTO.1).
+//
+// Authoritative source: `docs/tasks/automation.md` AUTO.1 "Key code shapes"
+// section + memory `project_opensquid_modular_function_skill_separation`.
+//
+// A skill's `triggers:` list declares which `Event` kinds the dispatcher
+// should evaluate the skill against. Default (block omitted at the Skill
+// level) is `[{kind: 'tool_call'}]` — back-compat with every Phase 1–7 pack
+// that pre-dates the wider Event union.
+//
+// Discriminated union on `kind` matching `EventKind` (one variant per Event
+// kind) so the schema can carry kind-specific filter args without leaking
+// into the bare event payload. Per-trigger filter args are loose at AUTO.1
+// and refined by the downstream trigger sources:
+//
+//   - `schedule.cron`         — read by SCHED.1 scheduler
+//   - `webhook.path`          — read by SCHED.2 webhook intake
+//   - `file_changed.paths`    — read by AUTO.5 chokidar watcher
+//   - `inbound_channel.channel` — read by AUTO.6 inbound router (abstract
+//                                channel name; user maps via channels.yaml)
+//
+// `tool_call`, `prompt_submit`, `session_end`, `stop` carry no filter args
+// at this layer — the host hook delivers the event verbatim and the rule
+// process inside the skill does any per-tool / per-prompt filtering via the
+// existing `tool_name`, `tool_args`, `match_command` primitives.
+//
+// Risk callout (per task spec): the loader MUST refuse an empty
+// `triggers: []` rather than silently defaulting to "all kinds" or "no
+// kinds." Empty means the pack author wrote something they didn't intend;
+// the schema rejects with a Zod issue path pointing at the offending field.
+// ---------------------------------------------------------------------------
+/**
+ * Re-export the eight event kinds as the canonical trigger-kind set.
+ *
+ * Trigger.kind ⊆ EventKind by construction (each `Trigger` variant's
+ * discriminator is one of the eight `EventKind` literals). Consumers that
+ * need the bare set of trigger kinds (audit logs, doctor output, AUTO.2
+ * `rate_limits:` keys) import this rather than re-typing the literals.
+ *
+ * The `Trigger` schema + `DEFAULT_TRIGGERS` constant itself lives in
+ * `runtime/types.ts` (single source of truth alongside `Event`). YAML
+ * callers should import them from there directly; skill.ts only references
+ * them via the local `import` for the Skill schema's `triggers:` field.
+ */
+export const TriggerKind = EventKind;
+// ---------------------------------------------------------------------------
+// LoadModeEnum — preload vs lazy per design doc §"Skill properties".
+//
+// `preload` — loaded at session start, stays loaded (always-active discipline).
+// `lazy`    — loaded when `when_to_load` fires; unloaded per `unloads_when`.
+// Default: lazy (context-minimization preference per
+// `project_opensquid_reduced_context_first_principle`).
+// ---------------------------------------------------------------------------
+export const LoadModeEnum = z.enum(['preload', 'lazy']);
+// ---------------------------------------------------------------------------
+// Skill — one skill's full definition.
+//
+// `tools` — bundled skill-internal scripts/check-functions (NOT MCP tools).
+// `prose` — optional LLM-facing guidance loaded only when the skill is active.
+// ---------------------------------------------------------------------------
+export const Skill = z.object({
+    name: z.string().min(1),
+    load: LoadModeEnum.default('lazy'),
+    when_to_load: z.array(Matcher).default([]),
+    // T-ASC ASC.2: AND-semantic preconditions evaluated at the dispatcher
+    // boundary BEFORE walking rules. Empty array trivially holds (back-compat
+    // with every Phase 1+ pack — defaults applied). Each entry is a
+    // discriminated-union variant from `runtime/skill_requires.ts` (kinds:
+    // automation_mode_on, active_task_present, chain_stage). A skill that
+    // declares `requires:` short-circuits at the dispatcher when any
+    // precondition fails — its rules don't evaluate.
+    requires: z.array(SkillRequires).default([]),
+    unloads_when: z.array(UnloadCondition).default([]),
+    // AUTO.1: `triggers:` declares which `Event` kinds fire this skill.
+    // - omitted        → default to `[{kind: 'tool_call'}]` via the factory
+    //                    above (back-compat with every Phase 1–7 pack).
+    // - non-empty list → discriminated union per `EventKind`; the dispatcher
+    //                    filters by `event.kind ∈ triggers.map(t => t.kind)`.
+    // - empty list     → REJECTED (`.min(1)`). Refusing to load an explicitly
+    //                    empty trigger list is the no-silent-fail-open posture
+    //                    required by the spec risk callout: the loader never
+    //                    silently disables a skill, and never silently enables
+    //                    every event kind.
+    triggers: z
+        .array(Trigger)
+        .min(1, 'triggers must not be empty — omit the block to default to tool_call')
+        .default(defaultTriggers),
+    rules: z.array(Rule).default([]),
+    tools: z.array(z.string()).default([]),
+    prose: z.string().optional(),
+});
+//# sourceMappingURL=skill.js.map

package/dist/packs/schemas/skill.js.map

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

package/dist/packs/schemas/team.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Zod schema for `team.yaml` — Mode A team-pack manifest extension.
+ *
+ * Authoritative source: `docs/opensquid-real-design.md` §"Team modes" Mode A
+ * + memory `project_opensquid_team_modes` (Mode A = one agent + Agent-tool
+ * subagents for profession-instantiation; Mode B = multi-tenant, future).
+ *
+ * A team pack declares a list of subagent ROLES that the parent agent can
+ * spawn via the `spawn_subagent` primitive (Task 6.2). Each role binds:
+ *
+ *   - `name`           — role identifier the parent references when spawning.
+ *   - `pack`           — the profession pack the subagent loads (e.g.
+ *                        `profession/code-reviewer`). The subagent's universal
+ *                        pinned skills come from its OWN pack set, NOT the
+ *                        parent's — see context inheritance (Task 6.3).
+ *   - `model_alias`    — model-neutral task-purpose label (e.g. `reasoning`,
+ *                        `fast_classifier`). Resolved against the user's
+ *                        `models.yaml` at spawn time, never hardcoded to a
+ *                        vendor model name.
+ *   - `handoff_signal` — optional sentinel string the subagent emits to
+ *                        signal completion (e.g. `'REVIEW_COMPLETE'`). Parent
+ *                        scans subagent stdout for this signal.
+ *   - `instructions`   — optional role-specific system prompt addendum.
+ *
+ * Model neutrality (per `project_opensquid_model_neutral_subagent_primitive`):
+ * `model_alias` is a USER-SUPPLIED alias name, never a concrete vendor model
+ * id. The schema validates only that it's a non-empty string — the alias
+ * resolution happens at spawn time against the active models config.
+ *
+ * `.min(1)` on `roles` enforces "a team has at least one role". An empty
+ * team pack is a configuration error (no subagents to spawn means the
+ * Mode-A orchestration this file exists to support is silently broken).
+ *
+ * Imports from: zod only (self-contained per audit constraint).
+ * Imported by: src/packs/schemas/index.ts.
+ */
+import { z } from 'zod';
+export declare const SubagentRole: z.ZodObject<{
+    name: z.ZodString;
+    pack: z.ZodString;
+    model_alias: z.ZodString;
+    handoff_signal: z.ZodOptional<z.ZodString>;
+    instructions: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    pack: string;
+    model_alias: string;
+    handoff_signal?: string | undefined;
+    instructions?: string | undefined;
+}, {
+    name: string;
+    pack: string;
+    model_alias: string;
+    handoff_signal?: string | undefined;
+    instructions?: string | undefined;
+}>;
+export type SubagentRole = z.infer<typeof SubagentRole>;
+export declare const Team: z.ZodObject<{
+    name: z.ZodString;
+    roles: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        pack: z.ZodString;
+        model_alias: z.ZodString;
+        handoff_signal: z.ZodOptional<z.ZodString>;
+        instructions: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        pack: string;
+        model_alias: string;
+        handoff_signal?: string | undefined;
+        instructions?: string | undefined;
+    }, {
+        name: string;
+        pack: string;
+        model_alias: string;
+        handoff_signal?: string | undefined;
+        instructions?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    roles: {
+        name: string;
+        pack: string;
+        model_alias: string;
+        handoff_signal?: string | undefined;
+        instructions?: string | undefined;
+    }[];
+}, {
+    name: string;
+    roles: {
+        name: string;
+        pack: string;
+        model_alias: string;
+        handoff_signal?: string | undefined;
+        instructions?: string | undefined;
+    }[];
+}>;
+export type Team = z.infer<typeof Team>;
+//# sourceMappingURL=team.d.ts.map

package/dist/packs/schemas/team.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team.d.ts","sourceRoot":"","sources":["../../../src/packs/schemas/team.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;EAMvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AASxD,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC"}

package/dist/packs/schemas/team.js

@@ -0,0 +1,63 @@
+/**
+ * Zod schema for `team.yaml` — Mode A team-pack manifest extension.
+ *
+ * Authoritative source: `docs/opensquid-real-design.md` §"Team modes" Mode A
+ * + memory `project_opensquid_team_modes` (Mode A = one agent + Agent-tool
+ * subagents for profession-instantiation; Mode B = multi-tenant, future).
+ *
+ * A team pack declares a list of subagent ROLES that the parent agent can
+ * spawn via the `spawn_subagent` primitive (Task 6.2). Each role binds:
+ *
+ *   - `name`           — role identifier the parent references when spawning.
+ *   - `pack`           — the profession pack the subagent loads (e.g.
+ *                        `profession/code-reviewer`). The subagent's universal
+ *                        pinned skills come from its OWN pack set, NOT the
+ *                        parent's — see context inheritance (Task 6.3).
+ *   - `model_alias`    — model-neutral task-purpose label (e.g. `reasoning`,
+ *                        `fast_classifier`). Resolved against the user's
+ *                        `models.yaml` at spawn time, never hardcoded to a
+ *                        vendor model name.
+ *   - `handoff_signal` — optional sentinel string the subagent emits to
+ *                        signal completion (e.g. `'REVIEW_COMPLETE'`). Parent
+ *                        scans subagent stdout for this signal.
+ *   - `instructions`   — optional role-specific system prompt addendum.
+ *
+ * Model neutrality (per `project_opensquid_model_neutral_subagent_primitive`):
+ * `model_alias` is a USER-SUPPLIED alias name, never a concrete vendor model
+ * id. The schema validates only that it's a non-empty string — the alias
+ * resolution happens at spawn time against the active models config.
+ *
+ * `.min(1)` on `roles` enforces "a team has at least one role". An empty
+ * team pack is a configuration error (no subagents to spawn means the
+ * Mode-A orchestration this file exists to support is silently broken).
+ *
+ * Imports from: zod only (self-contained per audit constraint).
+ * Imported by: src/packs/schemas/index.ts.
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// SubagentRole — one declarative role inside a team pack.
+//
+// `pack` + `model_alias` are required strings (min 1) because spawn-time
+// resolution against the pack registry + models config has no sensible
+// fallback. `handoff_signal` + `instructions` stay optional — most roles
+// terminate on natural completion and inherit the profession pack's prompt.
+// ---------------------------------------------------------------------------
+export const SubagentRole = z.object({
+    name: z.string().min(1),
+    pack: z.string().min(1),
+    model_alias: z.string().min(1),
+    handoff_signal: z.string().optional(),
+    instructions: z.string().optional(),
+});
+// ---------------------------------------------------------------------------
+// Team — the team pack's role list.
+//
+// `name` identifies the team (e.g. `review-team`, `incident-response-team`).
+// `roles.min(1)` blocks zero-role teams at load time.
+// ---------------------------------------------------------------------------
+export const Team = z.object({
+    name: z.string().min(1),
+    roles: z.array(SubagentRole).min(1),
+});
+//# sourceMappingURL=team.js.map

package/dist/packs/schemas/team.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team.js","sourceRoot":"","sources":["../../../src/packs/schemas/team.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8EAA8E;AAC9E,0DAA0D;AAC1D,EAAE;AACF,yEAAyE;AACzE,uEAAuE;AACvE,yEAAyE;AACzE,4EAA4E;AAC5E,8EAA8E;AAE9E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAGH,8EAA8E;AAC9E,oCAAoC;AACpC,EAAE;AACF,6EAA6E;AAC7E,sDAAsD;AACtD,8EAA8E;AAE9E,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACpC,CAAC,CAAC"}

package/dist/packs/seed_lessons_ingest.d.ts

@@ -0,0 +1,30 @@
+import type { EngineClient } from '../engine/client.js';
+import type { SeedLesson } from './schemas/manifest.js';
+export interface IngestResult {
+    ingested: number;
+    skipped: number;
+    failed: readonly {
+        title: string;
+        error: string;
+    }[];
+}
+/**
+ * Ingest `seeds` into the engine. Returns `{ingested, skipped, failed}`:
+ *   - `ingested`: seeds that the engine accepted as NEW rows
+ *     (`result.updated === false`)
+ *   - `skipped`:  seeds the engine UPSERTed onto an existing row
+ *     (`result.updated === true`)  — idempotent re-ingest
+ *   - `failed`:   per-seed RPC errors (engine down, validation error,
+ *     network blip). Never thrown — callers log.
+ */
+export declare function ingestSeedLessons(packName: string, packVersion: string, seeds: readonly SeedLesson[], engine: EngineClient, packDir: string): Promise<IngestResult>;
+/**
+ * sha256-derived external_id for engine UPSERT.
+ *
+ * Stable across opensquid processes for the same (pack@version + title),
+ * collision-resistant under pack-author discipline (no two seeds in one
+ * pack share a title). Different packs that happen to use the same title
+ * produce distinct external_ids because pack name is part of the input.
+ */
+export declare function makeExternalId(packName: string, packVersion: string, title: string): string;
+//# sourceMappingURL=seed_lessons_ingest.d.ts.map

package/dist/packs/seed_lessons_ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed_lessons_ingest.d.ts","sourceRoot":"","sources":["../../src/packs/seed_lessons_ingest.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACrD;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,CAAC,CA2BvB;AAiCD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG3F"}

package/dist/packs/seed_lessons_ingest.js

@@ -0,0 +1,107 @@
+/**
+ * DOG.3 — seed_lessons -> engine.lessonCreate ingest.
+ *
+ * Wraps the engine's `lesson.create` JSON-RPC (pack-authored variant) so
+ * each `SeedLesson` declared in a pack's manifest lands in the engine's
+ * lessons table at load time:
+ *   - `authored_by: 'pack'` + `pack_id` — engine treats pack-authored
+ *     lessons as eviction-immune (mirrors user-authored behaviour per
+ *     `feedback_user_authored_lessons_immune`).
+ *   - `seed_as_promoted: true` — bypasses the pending->promoted gate so
+ *     seed knowledge is immediately recall-eligible (matches the v1.1
+ *     pack-author surface in `src/engine/types.ts`).
+ *   - `external_id: pack-seed:<sha256-24>` — stable across re-ingestion
+ *     so the engine UPSERTs (`updated: true`) instead of duplicating.
+ *
+ * Fire-and-forget contract: per-seed failures are COLLECTED, never
+ * thrown. `loadPack` invokes this in a `void` context so a missing or
+ * down engine NEVER blocks pack load — the seeds simply aren't queryable
+ * until the next load with an engine present.
+ *
+ * Per-seed error isolation: one failing seed does not abort the rest.
+ */
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+import { isAbsolute, resolve, sep } from 'node:path';
+/**
+ * Ingest `seeds` into the engine. Returns `{ingested, skipped, failed}`:
+ *   - `ingested`: seeds that the engine accepted as NEW rows
+ *     (`result.updated === false`)
+ *   - `skipped`:  seeds the engine UPSERTed onto an existing row
+ *     (`result.updated === true`)  — idempotent re-ingest
+ *   - `failed`:   per-seed RPC errors (engine down, validation error,
+ *     network blip). Never thrown — callers log.
+ */
+export async function ingestSeedLessons(packName, packVersion, seeds, engine, packDir) {
+    let ingested = 0;
+    let skipped = 0;
+    const failed = [];
+    for (const seed of seeds) {
+        try {
+            const body = await resolveSeedBody(seed, packDir);
+            const result = await engine.lessonCreate({
+                description: seed.title,
+                body,
+                authored_by: 'pack',
+                pack_id: packName,
+                external_id: makeExternalId(packName, packVersion, seed.title),
+                seed_as_promoted: true,
+            });
+            if (result.updated)
+                skipped += 1;
+            else
+                ingested += 1;
+        }
+        catch (e) {
+            failed.push({
+                title: seed.title,
+                error: e instanceof Error ? e.message : String(e),
+            });
+        }
+    }
+    return { ingested, skipped, failed };
+}
+/**
+ * Resolve a seed's body: inline `body` wins; otherwise read `body_path` as a
+ * file relative to the pack directory. The schema (`SeedLesson` refine)
+ * guarantees exactly one is set. body_path is path-traversal-confined to the
+ * pack dir — an absolute path or one that escapes the pack root throws (caught
+ * per-seed by the caller, isolating one bad seed from the rest). An
+ * empty/whitespace-only file throws too (engine requires a non-empty body).
+ */
+async function resolveSeedBody(seed, packDir) {
+    if (seed.body !== undefined)
+        return seed.body;
+    const rel = seed.body_path;
+    if (rel === undefined) {
+        // Unreachable given the schema XOR refine, but fail loud rather than send
+        // an empty body to the engine.
+        throw new Error('seed_lesson has neither body nor body_path');
+    }
+    if (isAbsolute(rel)) {
+        throw new Error(`seed_lesson body_path must be pack-relative, got absolute: ${rel}`);
+    }
+    const root = resolve(packDir);
+    const abs = resolve(root, rel);
+    if (abs !== root && !abs.startsWith(root + sep)) {
+        throw new Error(`seed_lesson body_path escapes the pack dir: ${rel}`);
+    }
+    const content = (await readFile(abs, 'utf8')).trim();
+    if (content.length === 0) {
+        throw new Error(`seed_lesson body_path resolved to an empty file: ${rel}`);
+    }
+    return content;
+}
+/**
+ * sha256-derived external_id for engine UPSERT.
+ *
+ * Stable across opensquid processes for the same (pack@version + title),
+ * collision-resistant under pack-author discipline (no two seeds in one
+ * pack share a title). Different packs that happen to use the same title
+ * produce distinct external_ids because pack name is part of the input.
+ */
+export function makeExternalId(packName, packVersion, title) {
+    const hash = createHash('sha256').update(`${packName}@${packVersion}|${title}`).digest('hex');
+    return `pack-seed:${hash.slice(0, 24)}`;
+}
+//# sourceMappingURL=seed_lessons_ingest.js.map

package/dist/packs/seed_lessons_ingest.js.map

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