opensquid 0.5.441 → 0.5.449

package/dist/packs/seed_lessons_ingest.js

@@ -1,107 +0,0 @@
-/**
- * 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

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

package/dist/project-cli.d.ts

@@ -1,7 +0,0 @@
-export declare class ProjectCliError extends Error {
-    readonly hint?: string | undefined;
-    constructor(message: string, hint?: string | undefined);
-}
-export type ProjectCliCmd = "init" | "info" | "list" | "prune";
-export declare function runProjectCli(cmd: ProjectCliCmd, argv: string[]): Promise<void>;
-//# sourceMappingURL=project-cli.d.ts.map

package/dist/project-cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"project-cli.d.ts","sourceRoot":"","sources":["../src.legacy/project-cli.ts"],"names":[],"mappings":"AA0BA,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,IAAI,CAAC,EAAE,MAAM;gBAD7B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA;CAKhC;AA2HD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE/D,wBAAsB,aAAa,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBrF"}

package/dist/project-cli.js

@@ -1,145 +0,0 @@
-/**
- * `opensquid project <subcommand>` — project identity CLI.
- *
- * Subcommands:
- *   init [--id <name>]   — create `.opensquid/project.json` at cwd
- *                          (refuses to overwrite without --force)
- *   info                 — print the resolved project + state
- *   list                 — list registered projects from the global
- *                          registry
- *   prune                — sweep registry for entries whose
- *                          `last_seen_path` no longer exists; mark
- *                          them as deleted
- */
-import * as crypto from "node:crypto";
-import * as path from "node:path";
-import { applyResolution, findProjectCard, loadRegistry, pruneDeleted, resolveProject, writeProjectCard, } from "./project.js";
-export class ProjectCliError extends Error {
-    hint;
-    constructor(message, hint) {
-        super(message);
-        this.hint = hint;
-        this.name = "ProjectCliError";
-    }
-}
-function parseFlags(argv) {
-    const args = [];
-    const opts = {};
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        if (a === "--force") {
-            opts.force = true;
-        }
-        else if (a === "--id" && argv[i + 1]) {
-            opts.id = argv[++i];
-        }
-        else {
-            args.push(a);
-        }
-    }
-    return { args, opts };
-}
-async function cmdInit(opts) {
-    const cwd = process.cwd();
-    const existing = await findProjectCard(cwd);
-    if (existing && !opts.force) {
-        throw new ProjectCliError(`project card already exists at ${existing.cardPath}`, "use --force to overwrite, or run `opensquid project info` to inspect");
-    }
-    // If `--id` not passed, use the suggested default (git basename or cwd).
-    const resolved = await resolveProject(cwd);
-    const suggestedId = resolved.kind === "new" ? resolved.suggested_id : (existing?.card.id ?? "project");
-    const id = opts.id ?? suggestedId;
-    // Build the card directly so we can honor force without going through
-    // applyResolution's no-clobber pathway.
-    const card = {
-        version: 1,
-        id,
-        uuid: existing?.card.uuid ?? crypto.randomUUID(),
-        created_at: existing?.card.created_at ?? new Date().toISOString(),
-    };
-    await writeProjectCard(cwd, card, { force: !!existing });
-    // Register / refresh in the global registry.
-    await applyResolution(cwd, await resolveProject(cwd), { autoCreate: false });
-    console.log(`[opensquid project init] wrote ${path.join(cwd, ".opensquid", "project.json")}`);
-    console.log(`  id:   ${card.id}`);
-    console.log(`  uuid: ${card.uuid}`);
-}
-async function cmdInfo() {
-    const cwd = process.cwd();
-    const resolved = await resolveProject(cwd);
-    switch (resolved.kind) {
-        case "known": {
-            const projectRoot = path.dirname(path.dirname(resolved.cardPath));
-            console.log(`[opensquid project info] state: KNOWN`);
-            console.log(`  id:           ${resolved.card.id}`);
-            console.log(`  uuid:         ${resolved.card.uuid}`);
-            console.log(`  created_at:   ${resolved.card.created_at}`);
-            console.log(`  project root: ${projectRoot}`);
-            console.log(`  card:         ${resolved.cardPath}`);
-            return;
-        }
-        case "moved": {
-            const projectRoot = path.dirname(path.dirname(resolved.cardPath));
-            console.log(`[opensquid project info] state: MOVED`);
-            console.log(`  id:           ${resolved.card.id}`);
-            console.log(`  uuid:         ${resolved.card.uuid}`);
-            console.log(`  moved from:   ${resolved.from_path}`);
-            console.log(`  now at:       ${projectRoot}`);
-            console.log(`  hint: run \`opensquid project init --force\` or any memorize call`);
-            console.log(`        to update the registry's last-seen path.`);
-            return;
-        }
-        case "new": {
-            console.log(`[opensquid project info] state: NEW (no card found)`);
-            console.log(`  suggested id: ${resolved.suggested_id}`);
-            console.log(`  hint: run \`opensquid project init [--id NAME]\` to claim this dir`);
-            return;
-        }
-    }
-}
-async function cmdList() {
-    const reg = await loadRegistry();
-    const entries = Object.entries(reg.projects);
-    if (entries.length === 0) {
-        console.log(`[opensquid project list] no projects registered yet`);
-        return;
-    }
-    // Stable ordering: active first by last_seen_at desc, then deleted.
-    entries.sort(([, a], [, b]) => {
-        if (a.status !== b.status)
-            return a.status === "active" ? -1 : 1;
-        return b.last_seen_at.localeCompare(a.last_seen_at);
-    });
-    console.log(`[opensquid project list] ${entries.length} registered:`);
-    for (const [uuid, entry] of entries) {
-        const tag = entry.status === "active" ? "  " : "× ";
-        console.log(`${tag}${entry.id.padEnd(28)} ${entry.last_seen_path}`);
-        console.log(`    uuid=${uuid}  last_seen=${entry.last_seen_at}`);
-    }
-}
-async function cmdPrune() {
-    const res = await pruneDeleted();
-    if (res.swept === 0) {
-        console.log(`[opensquid project prune] no stale entries`);
-        return;
-    }
-    console.log(`[opensquid project prune] marked ${res.swept} entr${res.swept === 1 ? "y" : "ies"} as deleted: ${res.removed_ids.join(", ")}`);
-}
-export async function runProjectCli(cmd, argv) {
-    const { opts } = parseFlags(argv);
-    switch (cmd) {
-        case "init":
-            await cmdInit(opts);
-            return;
-        case "info":
-            await cmdInfo();
-            return;
-        case "list":
-            await cmdList();
-            return;
-        case "prune":
-            await cmdPrune();
-            return;
-    }
-}
-//# sourceMappingURL=project-cli.js.map

package/dist/project-cli.js.map

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

package/dist/project.d.ts

@@ -1,127 +0,0 @@
-/**
- * Project identity — decouple project scope from filesystem path.
- *
- * Two artifacts work together:
- *
- *   1. **Local ID card** at `<project-root>/.opensquid/project.json` —
- *      stable identity that travels with the project across moves /
- *      renames. Contains `id` (human-friendly), `uuid` (machine-stable),
- *      `created_at`.
- *
- *   2. **Global registry** at `~/.opensquid/projects.json` — index of
- *      all known projects by uuid. Tracks `last_seen_path`,
- *      `last_seen_at`, `status` (active|deleted) so we can detect
- *      moves and prune deletes.
- *
- * State machine on `resolveProject(cwd)`:
- *
- *   - card present, registry agrees on path → **known**
- *   - card present, registry has different path for this uuid → **moved**
- *     (registry's old path may or may not still exist; we update both)
- *   - card absent → **new** (caller decides whether to auto-create)
- *
- * `pruneDeleted()` sweeps the registry: for each active entry whose
- * `last_seen_path` no longer exists on disk, flip status to "deleted".
- */
-export interface ProjectCard {
-    /** Schema version; bump when the file shape changes. */
-    version: 1;
-    /** Human-friendly id (default: git basename of project root). */
-    id: string;
-    /** Machine-stable uuid that survives moves + id renames. */
-    uuid: string;
-    /** ISO timestamp the card was first written. */
-    created_at: string;
-}
-export type ProjectStatus = "active" | "deleted";
-export interface RegistryEntry {
-    id: string;
-    last_seen_path: string;
-    last_seen_at: string;
-    created_at: string;
-    status: ProjectStatus;
-}
-export interface Registry {
-    version: 1;
-    /** Map of uuid → registry entry. */
-    projects: Record<string, RegistryEntry>;
-}
-export type ResolvedProject = {
-    kind: "known";
-    card: ProjectCard;
-    cardPath: string;
-} | {
-    kind: "moved";
-    card: ProjectCard;
-    cardPath: string;
-    from_path: string;
-} | {
-    kind: "new";
-    project_root: string | null;
-    suggested_id: string;
-};
-/** Path to the registry file. */
-export declare function registryPath(dataRoot?: string): string;
-/** Path the ID card WOULD live at for a given project root. */
-export declare function cardPathForRoot(projectRoot: string): string;
-/**
- * Walk up from `cwd` looking for a `.opensquid/project.json` card.
- * Stops at the filesystem root. Returns the card + the path the
- * card was found at, or null if no card exists in any ancestor.
- */
-export declare function findProjectCard(cwd: string): Promise<{
-    card: ProjectCard;
-    cardPath: string;
-} | null>;
-/**
- * Write a project card at `<projectRoot>/.opensquid/project.json`.
- * Refuses to overwrite an existing card unless `force` is set —
- * overwriting is a manual operation, not an accidental one.
- */
-export declare function writeProjectCard(projectRoot: string, card: ProjectCard, options?: {
-    force?: boolean;
-}): Promise<{
-    cardPath: string;
-}>;
-export declare function loadRegistry(dataRoot?: string): Promise<Registry>;
-export declare function saveRegistry(reg: Registry, dataRoot?: string): Promise<void>;
-/**
- * Determine the project state for a given cwd.
- *
- * - Walks up from cwd for a card.
- * - Cross-references with the registry.
- * - Returns the state without mutating either file.
- *
- * `applyResolution` is the side-effect step: it updates the registry
- * based on the resolved state (and creates a card for `new` IF the
- * caller asks it to).
- */
-export declare function resolveProject(cwd: string, options?: {
-    dataRoot?: string;
-}): Promise<ResolvedProject>;
-/**
- * Side-effecting companion to `resolveProject`. Updates the registry
- * (creating the card if asked for `new`). Idempotent.
- *
- * - `known`: bump `last_seen_at` only.
- * - `moved`: update `last_seen_path` + `last_seen_at`.
- * - `new`: if `autoCreate` is true, create a card at `cwd` + register
- *   it. Otherwise return null.
- */
-export declare function applyResolution(cwd: string, resolved: ResolvedProject, options?: {
-    dataRoot?: string;
-    autoCreate?: boolean;
-    id?: string;
-}): Promise<ProjectCard | null>;
-/**
- * Mark registry entries as "deleted" when their `last_seen_path` no
- * longer exists on disk. Does NOT actually remove the entry — kept
- * for historical reference and so the user can see what they had.
- *
- * Returns the count of entries that flipped from active → deleted.
- */
-export declare function pruneDeleted(dataRoot?: string): Promise<{
-    swept: number;
-    removed_ids: string[];
-}>;
-//# sourceMappingURL=project.d.ts.map

package/dist/project.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src.legacy/project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAaH,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,OAAO,EAAE,CAAC,CAAC;IACX,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAC;IACX,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,CAAC,CAAC;IACX,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACzC;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAUN,iCAAiC;AACjC,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE3D;AAMD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAiBzD;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAoB/B;AAMD,wBAAsB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAUvE;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIlF;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,OAAO,CAAC,eAAe,CAAC,CAkB1B;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAO,GACrE,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAqD7B;AAMD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC,CAiBD"}