opensquid 0.5.395

package/dist/codex/types.d.ts

@@ -0,0 +1,398 @@
+/**
+ * Codex format — opensquid's native schema for living skill packs.
+ *
+ * A codex bundles seed lessons + memory templates + verify gates +
+ * doc-fetch declarations + foundational identity. Engine knows nothing
+ * about this format; it only sees the resulting lessons seeded via
+ * `lesson.create` with `authored_by: Pack(<codex-id>)`.
+ *
+ * See:
+ *   - /Users/slee/projects/loop/docs/opensquid-v0.6-design.md §4
+ *   - /Users/slee/projects/loop/docs/engine-v1.1-substrate-design.md
+ */
+/** A tool / software / instrument / product the codex knows about. */
+export interface CodexTool {
+    name: string;
+    /** SemVer range expression. Omit for unversioned tools. */
+    semver?: string;
+}
+/**
+ * Foundation declares what the codex is ABOUT (descriptive).
+ *
+ * Separate from `detected_by` which decides whether to ACTIVATE here.
+ * The same `atomic-design` codex (methodology) plugs into React, Vue,
+ * or Angular projects equally — its foundation is the methodology,
+ * activation is per-project.
+ *
+ * Each dimension is optional. A focused codex can declare any subset.
+ */
+export interface CodexFoundation {
+    /** Software, instruments, applications, products. */
+    tools?: CodexTool[];
+    /** Field of work / subject area (e.g. "single-cell-genomics"). */
+    domains?: string[];
+    /** Ways of working (e.g. "atomic-design", "IRAC"). */
+    methodologies?: string[];
+}
+/**
+ * Where the codex naturally applies. Defaults to `project`.
+ *
+ * - `project` — activate when project signals match (per-cwd)
+ * - `user` — activate globally for this user (no project signals needed)
+ * - `hybrid` — needs both user-level AND project-level signals
+ * - `team` — activate for declared team members
+ * - `global` — always-on (rare; system-level only)
+ */
+export type CodexActivationScope = "project" | "user" | "hybrid" | "team" | "global";
+/**
+ * Detection signals — when should this codex activate.
+ *
+ * Filesystem kinds work for developers/scientists/designers/screenwriters.
+ * Memory + conversation + user-pinned kinds cover non-filesystem roles
+ * (lawyers, therapists, parents, athletes).
+ */
+export type CodexDetection = {
+    kind: "file_exists";
+    path: string;
+} | {
+    kind: "dir_exists";
+    path: string;
+} | {
+    kind: "file_match";
+    path: string;
+    matches: Record<string, unknown>;
+} | {
+    kind: "file_glob";
+    pattern: string;
+    min_count?: number;
+} | {
+    kind: "memory_match";
+    memory_kind: string;
+    value: string;
+} | {
+    kind: "conversation_signal";
+    contains: string[];
+} | {
+    kind: "user_pinned";
+} | {
+    kind: "all_of";
+    conditions: CodexDetection[];
+} | {
+    kind: "any_of";
+    conditions: CodexDetection[];
+};
+/**
+ * How much of a seed lesson goes into the agent's working memory bank.
+ *
+ * - `full` — trigger + entire body embedded; fully eager
+ * - `trigger_only` — only trigger string searchable; body via `get_memory`
+ * - `summary` — LLM-generated summary in bank; full body lazy
+ * - `none` — not in bank; only reachable via citation id lookup
+ */
+export type CodexBankStrategy = "full" | "trigger_only" | "summary" | "none";
+/** Trigger condition (string form OR structured). */
+export type CodexTrigger = string | {
+    /** Intent description ("before creating a component"). */
+    intent: string;
+    /** Prescriptive phrasing for engine wire format. */
+    prescriptive_form?: string;
+};
+export interface CodexSeedLesson {
+    /** Stable id within the codex. */
+    id: string;
+    /** When the lesson applies (router intent). */
+    trigger: CodexTrigger;
+    /** Importance signal for orchestrator ranking. */
+    priority?: "high" | "medium" | "low";
+    /** Default: `full`. */
+    bank_strategy?: CodexBankStrategy;
+    /** Path to lesson markdown body, relative to codex root. */
+    body_path: string;
+    /** Optional evidence citations to memories the lesson cites. */
+    citations?: string[];
+}
+/** When the gate fires. */
+export interface CodexVerifyTrigger {
+    /** Match by tool call (e.g. "Write"). */
+    tool_call?: string;
+    /** Glob over target file path (e.g. "src/components/**\/*.tsx"). */
+    file_pattern?: string;
+    /** Or match by intent description. */
+    intent?: string;
+}
+/** Free-form requirement payload — orchestrator interprets. */
+export type CodexVerifyRequirement = Record<string, unknown>;
+export interface CodexVerifyGate {
+    id: string;
+    before: CodexVerifyTrigger;
+    require: CodexVerifyRequirement[];
+}
+export interface CodexMemoryTemplate {
+    /** Path or glob to scan. */
+    scan: string;
+    /** Field paths to extract from scanned file. */
+    extract: string[];
+    /** How to store extracted data as a memory. */
+    memorize_as?: {
+        kind: string;
+        scope?: string;
+    };
+}
+export interface CodexDocFetch {
+    trigger: string;
+    url: string;
+    /** Cache lifetime in days. */
+    ttl_days?: number;
+}
+export interface CodexReferenceDoc {
+    path: string;
+    bank_strategy?: CodexBankStrategy;
+}
+/** Severity for drift / workflow / claim findings. */
+export type CodexDriftSeverity = "block" | "warn";
+/** Which tool a drift pattern matches against. */
+export type CodexDriftToolMatch = "Bash" | "Edit" | "Write" | "*";
+/** Drift pattern trigger — same shape as DriftTrigger in drift-patterns.ts. */
+export type CodexDriftTrigger = {
+    kind: "bash_contains";
+    needle: string;
+    strip_quotes?: boolean;
+} | {
+    kind: "bash_regex";
+    pattern: string;
+    strip_quotes?: boolean;
+} | {
+    kind: "text_regex";
+    pattern: string;
+    field: string;
+};
+/**
+ * A drift pattern entry — port of DriftPattern (drift-patterns.ts:20).
+ * The loader composes a catalog from all codex `drifts/` entries +
+ * the bundled-default's entries.
+ */
+export interface CodexDriftEntry {
+    id: string;
+    tool: CodexDriftToolMatch;
+    trigger: CodexDriftTrigger;
+    /** Lesson id in the workflow codex that owns this rule. */
+    lesson: string;
+    /** Agent-facing explanation surfaced when triggered. */
+    message: string;
+    severity: CodexDriftSeverity;
+}
+/**
+ * A single phase in a workflow. The `name` is the user's identifier
+ * (e.g. "pre_research", "learn", "code", "test", "audit",
+ * "post_research", "fix" for the locked 7-phase rule, or whatever
+ * sequence another user prefers).
+ */
+export interface CodexWorkflowPhase {
+    name: string;
+    /**
+     * When false, the phase may be skipped if the agent logs a
+     * `skip` entry with a reason in the phase ledger. When true, the
+     * workflow-gate refuses to allow the task's terminal action (commit,
+     * push, etc.) without a non-skip phase entry.
+     */
+    required: boolean;
+    /** Optional short description shown in error messages. */
+    description?: string;
+}
+/**
+ * Workflow definition — ordered phase sequence + which terminal action
+ * triggers gate enforcement. Multiple workflows can be defined per
+ * codex (e.g. one for "ship a feature", a shorter one for "ship a docs
+ * fix"); active workflow is selected by `default_workflow_id` or by
+ * an explicit `workflow_id` on the task.
+ */
+export interface CodexWorkflowEntry {
+    id: string;
+    phases: CodexWorkflowPhase[];
+    /**
+     * Tool calls that trigger the gate (e.g. ["git_commit", "git_push"]).
+     * The loader maps these to PreToolUse hook triggers.
+     */
+    enforce_on: string[];
+    description?: string;
+}
+/**
+ * Evidence shape for a claim — what tool call (or call composition)
+ * counts as fulfilling the claim. Mirrors honesty-ledger.ts evidence
+ * kinds. `any_of` is recursive so claims like "telegram-sent" can
+ * resolve via either of two MCP tools.
+ */
+export type CodexClaimEvidence = {
+    kind: "tool_call";
+    tool: string;
+} | {
+    kind: "bash_contains";
+    needle: string;
+} | {
+    kind: "bash_regex";
+    pattern: string;
+} | {
+    kind: "input_contains";
+    tool: string;
+    field: string;
+    needle: string;
+} | {
+    kind: "any_of";
+    options: CodexClaimEvidence[];
+} | {
+    kind: "any_tool";
+};
+/**
+ * A claim pattern — port of HonestyLedger pattern shape. Loader
+ * composes the active project's catalog + bundled-default.
+ */
+export interface CodexClaimEntry {
+    id: string;
+    /** Regex matched against assistant text since last user turn. */
+    claim_pattern: string;
+    /** Evidence shape that fulfills the claim. */
+    evidence: CodexClaimEvidence;
+    /** User-facing message when the claim is unfulfilled. */
+    unfulfilled_message: string;
+    severity: CodexDriftSeverity;
+}
+/**
+ * A policy entry — declarative rules the versioning-gate / other
+ * higher-level gates enforce. v1 ships two policy kinds:
+ *
+ *   - `versioning`: per-commit version bump policy (slot rules, etc.)
+ *   - `phase_logged`: require N phases logged before a terminal action
+ *
+ * The `params` shape is per-policy-kind; loader narrows by `kind`.
+ */
+export type CodexPolicyEntry = {
+    id: string;
+    kind: "versioning";
+    params: CodexVersioningPolicy;
+} | {
+    id: string;
+    kind: "phase_logged";
+    params: CodexPhaseLoggedPolicy;
+};
+export interface CodexVersioningPolicy {
+    /**
+     * When true, any commit touching src/** must include a version-line
+     * change in Cargo.toml / package.json. The existing versioning-gate
+     * v0.6.3 behavior. Pre-1.0 PATCH-ONLY rule defaults this to true.
+     */
+    per_commit_required: boolean;
+    /**
+     * Which slot the agent may bump. Pre-1.0 PATCH-ONLY rule restricts
+     * this to ["patch"]. A future stable codex may allow ["patch",
+     * "minor"] etc.
+     */
+    allowed_slots: Array<"patch" | "minor" | "major">;
+    /**
+     * Optional finer-grained policy: for a given change type, which slot
+     * is expected. Used by a future v0.8 lint-style check that detects
+     * "diff looks like a feature, was bumped as patch → block".
+     */
+    slot_for?: {
+        bug_fix?: "patch" | "minor" | "major";
+        feature?: "patch" | "minor" | "major";
+        breaking?: "patch" | "minor" | "major";
+    };
+}
+export interface CodexPhaseLoggedPolicy {
+    /** Workflow id whose phases must be logged. */
+    workflow_id: string;
+    /** Which terminal tool calls trigger this policy. */
+    enforce_on: string[];
+}
+/**
+ * v0.6d — provenance metadata attached when a codex is imported from
+ * a foreign format (SKILL.md from Anthropic skills / superpowers / ECC /
+ * Hermes skill directories). Absent on natively-authored codexes.
+ *
+ * Purpose: lets `opensquid codex doctor` / `list` surface the import
+ * lineage without scanning the body, and lets future exports note
+ * "this was originally a SKILL.md from <variant>".
+ */
+export interface CodexSource {
+    /** Format the codex was converted from. */
+    kind: "skill_md" | "native";
+    /**
+     * Variant flavor when known. Detection heuristic in
+     * import-skill-md.ts. Diagnostic only — does not change runtime
+     * behavior.
+     */
+    original_variant?: "anthropic" | "superpowers" | "ecc" | "hermes" | "unknown";
+    /** SKILL.md's original `name` frontmatter field (before slugify). */
+    original_name?: string;
+    /** Absolute path at import time (diagnostic). */
+    original_path?: string;
+    /** ISO 8601 timestamp the import ran. */
+    imported_at?: string;
+}
+/** Common header fields shared by both kinds. */
+interface CodexBaseHeader {
+    id: string;
+    version: string;
+    author?: {
+        name?: string;
+        contact?: string;
+    };
+    license?: string;
+    description?: string;
+    /** v0.6d: import provenance. Absent on natively-authored codexes. */
+    source?: CodexSource;
+    /**
+     * v0.6d: extensibility bucket. Used by the SKILL.md importer to
+     * preserve non-standard frontmatter fields (Hermes `platforms`,
+     * `metadata.hermes.tags`, ECC `origin`, etc.) so round-trip
+     * inspection is lossless. Natively-authored codexes can also use
+     * this for ad-hoc tags.
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Focused codex — the real unit of codex content. Has own foundation,
+ * own seed lessons, own gates, etc. Activates by its own `detected_by`.
+ */
+export interface FocusedCodex extends CodexBaseHeader {
+    kind?: "focused";
+    foundation?: CodexFoundation;
+    activation_scope?: CodexActivationScope;
+    detected_by?: CodexDetection[];
+    seed_lessons?: CodexSeedLesson[];
+    verify_gates?: CodexVerifyGate[];
+    memory_templates?: CodexMemoryTemplate[];
+    doc_fetch?: CodexDocFetch[];
+    reference_docs?: CodexReferenceDoc[];
+    /**
+     * Drift-as-codex sections (0.7.3+, additive). Hooks consume these
+     * via the loader (next chunk); existing codexes without them parse
+     * unchanged.
+     */
+    drifts?: CodexDriftEntry[];
+    workflows?: CodexWorkflowEntry[];
+    default_workflow_id?: string;
+    claims?: CodexClaimEntry[];
+    policies?: CodexPolicyEntry[];
+    /** When true, engine refines this codex via gated lesson promotion. */
+    evolves?: boolean;
+}
+/**
+ * Composite codex — pure aggregator of focused codexes. NO own content
+ * (no seed_lessons, no foundation, no gates). One-shot install of
+ * multiple focused codexes as a unit.
+ */
+export interface CompositeCodex extends CodexBaseHeader {
+    kind: "composite";
+    includes: CodexInclude[];
+}
+export interface CodexInclude {
+    id: string;
+    semver: string;
+}
+/** Either codex kind. Discriminate via `kind` field (default focused). */
+export type Codex = FocusedCodex | CompositeCodex;
+export declare function isCompositeCodex(c: Codex): c is CompositeCodex;
+export declare function isFocusedCodex(c: Codex): c is FocusedCodex;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/codex/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src.legacy/codex/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,sEAAsE;AACtE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAMD;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAErF;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpC;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,GACD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,UAAU,EAAE,cAAc,EAAE,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,UAAU,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC;AAMrD;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,cAAc,GAAG,SAAS,GAAG,MAAM,CAAC;AAM7E,qDAAqD;AACrD,MAAM,MAAM,YAAY,GACpB,MAAM,GACN;IACE,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEN,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,OAAO,EAAE,YAAY,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACrC,uBAAuB;IACvB,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAMD,2BAA2B;AAC3B,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,+DAA+D;AAC/D,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACnC;AAMD,MAAM,WAAW,mBAAmB;IAClC,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+CAA+C;IAC/C,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAMD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAcD,sDAAsD;AACtD,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,MAAM,CAAC;AAElD,kDAAkD;AAClD,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,GAAG,CAAC;AAElE,+EAA+E;AAC/E,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B;;;OAGG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,kBAAkB,EAAE,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAEzB;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,yDAAyD;IACzD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GACxB;IACE,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,qBAAqB,CAAC;CAC/B,GACD;IACE,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,sBAAsB,CAAC;CAChC,CAAC;AAEN,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,mBAAmB,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,aAAa,EAAE,KAAK,CAAC,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC;IAClD;;;;OAIG;IACH,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;QACtC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;QACtC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;KACxC,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAMD;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC5B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,WAAW,GAAG,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC9E,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,iDAAiD;AACjD,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAC/B,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IACjC,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IACjC,gBAAgB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACzC,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAC5B,cAAc,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACrC;;;;OAIG;IACH,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC9B,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,0EAA0E;AAC1E,MAAM,MAAM,KAAK,GAAG,YAAY,GAAG,cAAc,CAAC;AAMlD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,IAAI,cAAc,CAE9D;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,IAAI,YAAY,CAE1D"}

package/dist/codex/types.js

@@ -0,0 +1,21 @@
+/**
+ * Codex format — opensquid's native schema for living skill packs.
+ *
+ * A codex bundles seed lessons + memory templates + verify gates +
+ * doc-fetch declarations + foundational identity. Engine knows nothing
+ * about this format; it only sees the resulting lessons seeded via
+ * `lesson.create` with `authored_by: Pack(<codex-id>)`.
+ *
+ * See:
+ *   - /Users/slee/projects/loop/docs/opensquid-v0.6-design.md §4
+ *   - /Users/slee/projects/loop/docs/engine-v1.1-substrate-design.md
+ */
+// ---------------------------------------------------------------------
+// Type guards
+// ---------------------------------------------------------------------
+export function isCompositeCodex(c) {
+    return c.kind === "composite";
+}
+export function isFocusedCodex(c) {
+    return c.kind !== "composite";
+}

package/dist/codex/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src.legacy/codex/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAsaH,wEAAwE;AACxE,cAAc;AACd,wEAAwE;AAExE,MAAM,UAAU,gBAAgB,CAAC,CAAQ;IACvC,OAAO,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,CAAQ;IACrC,OAAO,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC;AAChC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Opensquid host-level config at `<data-root>/config.json`.
+ *
+ * Persists machine-state that's relevant across sessions but doesn't
+ * belong in per-project files or in the engine's lesson store. v0.4
+ * uses it to remember the engine binary path so moving the loop-engine
+ * checkout doesn't silently break opensquid.
+ *
+ * Resolution order for the engine binary (v0.6c):
+ *   1. `OPENSQUID_ENGINE_BIN` env var — explicit override, always wins
+ *   2. `<data-root>/config.json` `engine_bin` field — persisted choice
+ *   3. Bundled npm optional dep (`opensquid-engine-<platform>-<arch>`) —
+ *      shipped with `opensquid` for published installs (v0.6c)
+ *   4. Auto-search common dev paths (~/projects/{,*}/{loop/engine,engine}/target/release/loop-engine)
+ *   5. `loop-engine` on $PATH (manually-installed binary)
+ *   6. `null` — caller surfaces a helpful error
+ *
+ * The first successful resolution writes itself back to config.json so
+ * the next session picks up the same path immediately. Bundled-binary
+ * hits are NOT persisted to config because the path is deterministic
+ * from the npm install layout — re-resolving is free and stale-safe
+ * across opensquid upgrades.
+ */
+export interface OpensquidConfig {
+    version: 1;
+    /** Last-known path to the loop-engine binary. */
+    engine_bin?: string;
+    /** ISO timestamp the engine_bin was last resolved. */
+    engine_bin_resolved_at?: string;
+}
+export declare function loadConfig(dataRoot?: string): Promise<OpensquidConfig>;
+export declare function saveConfig(config: OpensquidConfig, dataRoot?: string): Promise<void>;
+/**
+ * Resolve the engine binary path using the priority chain above.
+ * Writes the resolved path back to config when discovered via search
+ * so the next session is instant.
+ *
+ * Returns `null` if no working binary could be located.
+ */
+export declare function resolveEngineBin(dataRoot?: string): Promise<string | null>;
+/**
+ * Set the engine binary path explicitly and persist. Validates that the
+ * path points at an executable file before writing.
+ */
+export declare function setEngineBin(binPath: string, dataRoot?: string): Promise<{
+    resolved: string;
+}>;
+/**
+ * Forget the persisted engine binary path. Forces re-discovery on the
+ * next `resolveEngineBin` call.
+ */
+export declare function forgetEngineBin(dataRoot?: string): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src.legacy/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAaH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAYD,wBAAsB,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAS5E;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI1F;AAQD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA2ChF;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAU/B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKtE"}