tracegrove 0.0.0-stage → 0.3.0

package/dist/authoring/schema.js

@@ -0,0 +1,147 @@
+/**
+ * Authoring layer: the short files people write (`tracegrove.config.yaml`, `*.flow.yaml`,
+ * `*.fixture.yaml`). They compile into the strict `workflow.*\/v1` corpus; nothing here is
+ * evidence by itself and nothing bypasses the planner, executor or reducer.
+ */
+import { z } from 'zod';
+import { ActionEnvelope, BrowserCommand, NativeJobAction, McpToolCall, Persona, HexSha256 } from "../protocol/index.js";
+export const HTTP_VERBS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD'];
+const Name = z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, 'use letters, digits, - and _ (start with a letter)');
+const DotPath = z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*(\[[0-9]+\])?(\.[A-Za-z_][A-Za-z0-9_]*(\[[0-9]+\])?)*$/, 'use a dot path like note.id or notes[0].title');
+const Path = z.string().regex(/^\//, 'paths start with /');
+const Status = z.number().int().min(100).max(599);
+const Json = z.lazy(() => z.union([z.string(), z.number(), z.boolean(), z.null(), z.array(Json), z.record(z.string(), Json)]));
+export const ADAPTERS = ['node', 'fastapi', 'django', 'command'];
+export const AGENT_PROVIDERS = ['claude', 'codex', 'none'];
+export const AuthoringConfig = z.object({
+    $schema: z.string().optional(),
+    project: Name.describe('Short project name, shown in reports and run summaries.'),
+    testDir: z.string().default('tracegrove').describe('Folder holding *.flow.yaml and fixtures/, relative to this file.'),
+    app: z.object({
+        adapter: z.enum(ADAPTERS).describe('Launch preset: node, fastapi, django or command.'),
+        nativeJobs: z.literal('node_ipc/v1').optional().describe('Opt in to the application-owned native Node job bridge.'),
+        root: z.string().default('.').describe('App directory relative to this file; the launch cwd.'),
+        entry: z.string().optional().describe('node: script path; fastapi: module:app; django: folder containing manage.py.'),
+        run: z.string().optional().describe('command adapter: shell command that starts the app on $PORT.'),
+        python: z.string().optional().describe('fastapi/django: interpreter (default .venv/bin/python when present, else python3).'),
+        health: Path.default('/health').describe('GET path that returns 2xx once the app is ready.'),
+        readyTimeoutMs: z.number().int().positive().max(300_000).default(20_000),
+        sources: z.array(z.string()).min(1).optional().describe('Globs (relative to root) whose bytes are attested as the tested source.'),
+        env: z.record(z.string(), z.string()).default({}).describe('Extra env; {port} and {dataDir} are substituted.'),
+        inject: z.object({
+            port: z.string().default('PORT'),
+            dataDir: z.string().default('TRACEGROVE_DATA_DIR'),
+            tokens: z.string().default('TRACEGROVE_TOKENS'),
+        }).strict().default({ port: 'PORT', dataDir: 'TRACEGROVE_DATA_DIR', tokens: 'TRACEGROVE_TOKENS' }),
+    }).strict(),
+    personas: z.record(Name, z.object({ subject: z.string().min(1),
+        ...Persona.pick({ locale: true, timezone: true, viewport: true, inputMode: true, reducedMotion: true }).partial().shape,
+    }).strict())
+        .refine((value) => Object.keys(value).length > 0, 'declare at least one persona')
+        .describe('Callers. The first one is the default `as:` for every step.'),
+    agent: z.object({
+        provider: z.enum(AGENT_PROVIDERS).default('claude').describe('Coding agent that drafts and repairs flows: claude (Claude Code CLI), codex (Codex CLI) or none.'),
+        model: z.string().min(1).max(120).optional().describe('Explicit model passed to the agent CLI. Defaults: claude-haiku-5-5 for claude; gpt-6-luna for codex.'),
+        maxBudgetUsd: z.number().positive().max(100).optional().describe('Spend cap per draft run, passed to Claude Code as --max-budget-usd.'),
+    }).strict().optional().describe('Agent settings. .tracegrove/settings.json (written by tracegrove ui) and CLI flags override these per developer.'),
+    defaults: z.object({
+        stepTimeoutMs: z.number().int().positive().max(120_000).default(5000),
+        caseTimeoutMs: z.number().int().positive().max(600_000).default(30_000),
+    }).strict().default({ stepTimeoutMs: 5000, caseTimeoutMs: 30_000 }),
+}).strict();
+export const Expect = z.union([
+    Status,
+    z.object({
+        status: Status.optional(),
+        json: z.record(DotPath, Json).optional().describe('Dot paths into the response body and their exact values.'),
+        present: z.array(DotPath).optional(),
+        absent: z.array(DotPath).optional(),
+        count: z.record(DotPath, z.number().int().nonnegative()).optional(),
+    }).strict(),
+]);
+const verbFields = Object.fromEntries(HTTP_VERBS.map((verb) => [verb, Path.optional()]));
+function exactlyOneVerb(value, ctx) {
+    const verbs = HTTP_VERBS.filter((verb) => value[verb] !== undefined);
+    if (verbs.length !== 1)
+        ctx.addIssue({ code: 'custom', message: `give exactly one of ${HTTP_VERBS.join(', ')} (found ${verbs.length ? verbs.join(', ') : 'none'})` });
+}
+export const HttpFlowStep = z.object({
+    name: z.string().min(1).max(120).optional(),
+    ...verbFields,
+    as: z.string().optional().describe('Persona name, or none for an unauthenticated call.'),
+    headers: z.record(z.string(), z.string()).optional(),
+    json: Json.optional().describe('Request body; {name} placeholders use saved values.'),
+    observe: z.boolean().optional().describe('Independent readback (GET/HEAD) polled until expect holds.'),
+    expect: Expect.optional(),
+    save: z.record(Name, DotPath).optional().describe('name: dot.path into the response body.'),
+    timeoutMs: z.number().int().positive().max(120_000).optional(),
+}).strict().superRefine(exactlyOneVerb);
+export const BrowserFlowStep = z.object({
+    name: z.string().min(1).max(120).optional(),
+    browser: BrowserCommand,
+    expect: z.object({ text: z.string().max(8192).optional(), status: Status.optional() }).strict().optional(),
+    timeoutMs: z.number().int().positive().max(120_000).optional(),
+}).strict();
+export const JobFlowStep = z.object({ name: z.string().min(1).max(120).optional(), job: NativeJobAction,
+    as: z.string().optional(), expect: Expect.optional(), save: z.record(Name, DotPath).optional(),
+    timeoutMs: z.number().int().positive().max(120_000).optional() }).strict();
+export const McpFlowStep = z.object({ name: z.string().min(1).max(120).optional(), mcp: McpToolCall,
+    as: z.string().optional(), expect: Expect.optional(), save: z.record(Name, DotPath).optional(),
+    timeoutMs: z.number().int().positive().max(120_000).optional() }).strict();
+export const FlowStep = z.union([HttpFlowStep, BrowserFlowStep, JobFlowStep, McpFlowStep]);
+export const Flow = z.object({
+    $schema: z.string().optional(),
+    title: z.string().min(1).max(400),
+    risk: z.enum(['critical', 'standard', 'exploratory']).default('standard'),
+    tags: z.array(Name).default([]),
+    as: z.string().optional().describe('Default persona for this flow.'),
+    given: z.record(Name, z.string()).default({}).describe('alias: fixture name (tracegrove/fixtures/<name>.fixture.yaml).'),
+    effects: ActionEnvelope.pick({ maxJobs: true, maxMcpCalls: true, allowedMcpTools: true }).partial().optional().describe('Explicit job and MCP effect ceilings; tool annotations do not grant authority.'),
+    browser: z.object({
+        allowPaths: z.array(Path).min(1).max(64).describe('Path prefixes in this flow’s effect envelope, including browser assets and API calls.'),
+        allowMethods: z.array(z.enum(HTTP_VERBS)).min(1).max(6).default(['GET', 'HEAD']),
+        maxActions: z.number().int().positive().max(10_000).default(100),
+        maxArtifactBytes: z.number().int().positive().max(16 * 1024 * 1024).default(4 * 1024 * 1024),
+    }).strict().optional(),
+    steps: z.array(FlowStep).min(1).max(50),
+}).strict().superRefine((flow, ctx) => {
+    if (flow.steps.some(step => 'browser' in step) && !flow.browser)
+        ctx.addIssue({ code: 'custom', path: ['browser'], message: 'browser steps require browser.allowPaths to declare the permitted page, asset, and API paths' });
+    flow.steps.forEach((step, index) => {
+        if (!('browser' in step))
+            return;
+        if (step.browser.kind === 'read' && step.expect?.text === undefined)
+            ctx.addIssue({ code: 'custom', path: ['steps', index, 'expect'], message: 'browser read requires expect.text; it polls until that text is observed' });
+        if (step.expect?.text !== undefined && step.browser.kind !== 'read')
+            ctx.addIssue({ code: 'custom', path: ['steps', index, 'expect', 'text'], message: 'text expectations need a browser read command' });
+        if (step.expect?.status !== undefined && step.browser.kind !== 'navigate')
+            ctx.addIssue({ code: 'custom', path: ['steps', index, 'expect', 'status'], message: 'status expectations need a browser navigate command' });
+    });
+});
+const FixtureValue = z.union([
+    Json,
+    z.object({ words: z.number().int().min(1).max(64) }).strict(),
+    z.object({ slug: z.literal(true) }).strict(),
+    z.object({ uuid: z.literal(true) }).strict(),
+    z.object({ int: z.object({ min: z.number().int(), max: z.number().int() }).strict() }).strict(),
+]);
+const FixtureCall = z.object({ ...verbFields, json: z.record(Name, FixtureValue).optional(), expect: Status.optional() }).strict().superRefine(exactlyOneVerb);
+export const Fixture = z.object({
+    $schema: z.string().optional(),
+    as: z.string().optional(),
+    create: FixtureCall,
+    save: z.record(Name, DotPath).refine((value) => Object.keys(value).length > 0, 'save at least the created id'),
+    readback: z.object({ GET: Path, expect: Expect }).strict(),
+    cleanup: z.object({ DELETE: Path, expect: Status.optional(), gone: z.object({ GET: Path, status: z.union([z.literal(404), z.literal(410)]) }).strict() }).strict(),
+}).strict();
+export const RunVideo = z.object({ digest: HexSha256, byteCount: z.number().int().positive().max(16 * 1024 * 1024), mediaType: z.literal('video/webm') }).strict();
+export function exportAuthoringSchemas() {
+    const opts = { target: 'draft-2020-12', io: 'input', unrepresentable: 'any' };
+    return {
+        'tracegrove.config/v1': z.toJSONSchema(AuthoringConfig, opts),
+        'tracegrove.flow/v1': z.toJSONSchema(Flow, opts),
+        'tracegrove.fixture/v1': z.toJSONSchema(Fixture, opts),
+        'tracegrove.run-video/v1': z.toJSONSchema(RunVideo, opts),
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/authoring/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/authoring/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAExH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAGrF,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,0BAA0B,EAAE,oDAAoD,CAAC,CAAC;AAChH,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,+EAA+E,EAAE,+CAA+C,CAAC,CAAC;AACnK,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC;AAC3D,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,IAAI,GAAuB,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAEnJ,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAC1E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC;AAGpE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,yDAAyD,CAAC;IACjF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,kEAAkE,CAAC;IACtH,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC;QACZ,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,kDAAkD,CAAC;QACtF,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;QACnH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,sDAAsD,CAAC;QAC9F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8EAA8E,CAAC;QACrH,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;QACnG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oFAAoF,CAAC;QAC5H,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,kDAAkD,CAAC;QAC5F,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACxE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yEAAyE,CAAC;QAClI,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,kDAAkD,CAAC;QAC9G,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;YAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC;YAClD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC;SAChD,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;KACnG,CAAC,CAAC,MAAM,EAAE;IACX,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5D,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK;KACxH,CAAC,CAAC,MAAM,EAAE,CAAC;SACT,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,8BAA8B,CAAC;SAChF,QAAQ,CAAC,6DAA6D,CAAC;IAC1E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,kGAAkG,CAAC;QAChK,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sGAAsG,CAAC;QAC7J,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qEAAqE,CAAC;KACxI,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kHAAkH,CAAC;IACnJ,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;QACjB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QACrE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;KACxE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC;CACpE,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC;IAC5B,MAAM;IACN,CAAC,CAAC,MAAM,CAAC;QACP,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;QACzB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;QAC7G,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE;QACpC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE;QACnC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,EAAE;KACpE,CAAC,CAAC,MAAM,EAAE;CACZ,CAAC,CAAC;AAGH,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAiD,CAAC;AAEzI,SAAS,cAAc,CAAC,KAA+C,EAAE,GAAoB;IAC3F,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC;IACrE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,uBAAuB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AACxK,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC3C,GAAG,UAAU;IACb,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;IACxF,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpD,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;IACrF,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;IACtG,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;IACzB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IAC3F,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE;CAC/D,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;AACxC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC3C,OAAO,EAAE,cAAc;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1G,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE;CAC/D,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,eAAe;IACrG,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,QAAQ,EAAE;IAC9F,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAC7E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,WAAW;IACjG,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,QAAQ,EAAE;IAC9F,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAC7E,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;AAG3F,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IACzE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACpE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,gEAAgE,CAAC;IACxH,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;IACzM,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,uFAAuF,CAAC;QAC1I,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAChF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;QAChE,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;KAC7F,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;CACxC,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;IACpC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,8FAA8F,EAAE,CAAC,CAAC;IAC9N,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACjC,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC;YAAE,OAAO;QACjC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,KAAK,SAAS;YAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,yEAAyE,EAAE,CAAC,CAAC;QAC5N,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM;YAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,+CAA+C,EAAE,CAAC,CAAC;QAC1M,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,UAAU;YAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,qDAAqD,EAAE,CAAC,CAAC;IAC1N,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAGH,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC;IAC3B,IAAI;IACJ,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IAC7D,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5C,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5C,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;CAChG,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;AAE/J,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,MAAM,EAAE,WAAW;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,8BAA8B,CAAC;IAC9G,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1D,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;CACnK,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAGnK,MAAM,UAAU,sBAAsB;IACpC,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,eAAwB,EAAE,EAAE,EAAE,OAAgB,EAAE,eAAe,EAAE,KAAc,EAAE,CAAC;IACzG,OAAO;QACL,sBAAsB,EAAE,CAAC,CAAC,YAAY,CAAC,eAAe,EAAE,IAAI,CAAC;QAC7D,oBAAoB,EAAE,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC;QAChD,uBAAuB,EAAE,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC;QACtD,yBAAyB,EAAE,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC;KAC1D,CAAC;AACJ,CAAC"}

package/dist/authoring/snapshotSource.d.ts

@@ -0,0 +1,13 @@
+import { GitSnapshotBinding, type Scope } from '../protocol/index.ts';
+/** Scoped source descriptor. Execution rechecks bytes under its own supervisor. */
+export declare class SnapshotSource {
+    readonly snapshot: GitSnapshotBinding['snapshot'];
+    readonly root: string;
+    private readonly resolutionPath;
+    constructor(manifestPath: string, scope: Scope);
+    bind(cwd: string, compiledDir: string, repositoryRole?: string): GitSnapshotBinding;
+    selection(pin: GitSnapshotBinding): {
+        selection: import("../protocol/index.ts").SourceSelection;
+        matrix: import("../protocol/index.ts").RevisionMatrix;
+    };
+}

package/dist/authoring/snapshotSource.js

@@ -0,0 +1,41 @@
+import { dirname, isAbsolute, join, relative, sep } from 'node:path';
+import { GitSnapshotBinding } from "../protocol/index.js";
+import { sameScope } from "../protocol/canonical.js";
+import { readGitSnapshotManifest, readGitSnapshotTree } from "../source/snapshotTree.js";
+import { Blocked } from "../core/errors.js";
+import { readBoundedFile } from "../core/boundedFile.js";
+import { snapshotSourceSelection } from "../core/snapshotRepository.js";
+/** Scoped source descriptor. Execution rechecks bytes under its own supervisor. */
+export class SnapshotSource {
+    snapshot;
+    root;
+    resolutionPath;
+    constructor(manifestPath, scope) {
+        this.snapshot = readGitSnapshotManifest(manifestPath);
+        if (!sameScope(this.snapshot.scope, scope))
+            throw new Blocked([{ code: 'snapshot_scope_mismatch', detail: 'snapshot belongs to another local owner' }]);
+        this.root = join(dirname(manifestPath), 'source');
+        this.resolutionPath = join(dirname(manifestPath), 'resolution.json');
+    }
+    bind(cwd, compiledDir, repositoryRole) {
+        const within = relative(this.root, cwd);
+        if (within.startsWith('..') || isAbsolute(within))
+            throw new Blocked([{ code: 'snapshot_app_outside_root', detail: 'app.root must be inside the materialized source tree' }]);
+        try {
+            readGitSnapshotTree(this.snapshot, this.root);
+        }
+        catch (error) {
+            throw new Blocked([{ code: 'snapshot_source_changed', detail: `Selected snapshot files are missing, unreadable, or differ from the manifest: ${error.message}`, action: 'restore the pinned files or materialize and review a new snapshot in Settings' }]);
+        }
+        return GitSnapshotBinding.parse({ snapshot: this.snapshot, root: relative(compiledDir, this.root).split(sep).join('/') || '.', cwd: within.split(sep).join('/') || '.', ...(repositoryRole === undefined ? {} : { repositoryRole }) });
+    }
+    selection(pin) {
+        try {
+            return snapshotSourceSelection(pin, JSON.parse(readBoundedFile(this.resolutionPath, 64 * 1024 * 1024).toString('utf8')));
+        }
+        catch (error) {
+            throw new Blocked([{ code: 'snapshot_repository_unbound', detail: error.message, action: 'materialize the selected resolver head with its resolution.json sidecar; bind one complete repository role' }]);
+        }
+    }
+}
+//# sourceMappingURL=snapshotSource.js.map

package/dist/authoring/snapshotSource.js.map

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

package/dist/authoring/sourceSelection.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+export declare const VerificationSourceSelection: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"working_tree">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"snapshot">;
+    path: z.ZodString;
+    ref: z.ZodObject<{
+        id: z.ZodString;
+        revision: z.ZodString;
+        digest: z.ZodObject<{
+            algorithm: z.ZodLiteral<"sha256">;
+            hex: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>], "kind">;
+export type VerificationSourceSelection = z.infer<typeof VerificationSourceSelection>;
+/** Describes requested local input; never grants remote identity or qualification. */
+export declare const VerificationSourceBinding: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"working_tree">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"snapshot">;
+    ref: z.ZodObject<{
+        id: z.ZodString;
+        revision: z.ZodString;
+        digest: z.ZodObject<{
+            algorithm: z.ZodLiteral<"sha256">;
+            hex: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    commit: z.ZodString;
+    files: z.ZodNumber;
+    bytes: z.ZodNumber;
+}, z.core.$strict>], "kind">;
+export type VerificationSourceBinding = z.infer<typeof VerificationSourceBinding>;

package/dist/authoring/sourceSelection.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import { GitObjectId, RefSchema } from "../protocol/primitives.js";
+export const VerificationSourceSelection = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('working_tree') }).strict(),
+    z.object({ kind: z.literal('snapshot'), path: z.string().min(1).max(8192), ref: RefSchema }).strict(),
+]);
+/** Describes requested local input; never grants remote identity or qualification. */
+export const VerificationSourceBinding = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('working_tree') }).strict(),
+    z.object({ kind: z.literal('snapshot'), ref: RefSchema, commit: GitObjectId,
+        files: z.number().int().positive(), bytes: z.number().int().nonnegative() }).strict(),
+]);
+//# sourceMappingURL=sourceSelection.js.map

package/dist/authoring/sourceSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceSelection.js","sourceRoot":"","sources":["../../src/authoring/sourceSelection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACtE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IACtD,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtG,CAAC,CAAC;AAGH,sFAAsF;AACtF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACpE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IACtD,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW;QACzE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;CACxF,CAAC,CAAC"}

package/dist/authoring/sources.d.ts

@@ -0,0 +1,5 @@
+export declare const MAX_SOURCE_FILES = 256;
+export declare function globToRegExp(glob: string): RegExp;
+/** Default globs: source files under the app root, minus dependency, cache and test-tool folders. */
+export declare function defaultSourceGlobs(): string[];
+export declare function expandSources(root: string, globs: string[], extraSkip?: string[]): string[];

package/dist/authoring/sources.js

@@ -0,0 +1,65 @@
+/** Expand source globs into the explicit file list the local launcher attests. */
+import { readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { Blocked } from "../core/errors.js";
+const SKIP_DIRS = new Set(['node_modules', '.git', '.venv', 'venv', '__pycache__', '.tracegrove', '.workflow-verify', 'dist', 'build', '.pytest_cache', '.mypy_cache', '.next', 'coverage']);
+const DEFAULT_EXTENSIONS = ['py', 'js', 'mjs', 'cjs', 'ts', 'mts', 'cts', 'jsx', 'tsx'];
+export const MAX_SOURCE_FILES = 256;
+export function globToRegExp(glob) {
+    let out = '';
+    for (let i = 0; i < glob.length; i++) {
+        const c = glob[i];
+        if (c === '*' && glob[i + 1] === '*') {
+            i++;
+            if (glob[i + 1] === '/') {
+                i++;
+                out += '(?:.*/)?';
+            }
+            else
+                out += '.*';
+        }
+        else if (c === '*')
+            out += '[^/]*';
+        else if (c === '?')
+            out += '[^/]';
+        else if (c === '{') {
+            const end = glob.indexOf('}', i);
+            if (end < 0) {
+                out += '\\{';
+                continue;
+            }
+            out += `(?:${glob.slice(i + 1, end).split(',').map((part) => part.replace(/[.+^$()|[\]\\]/g, '\\$&')).join('|')})`;
+            i = end;
+        }
+        else
+            out += c.replace(/[.+^$()|[\]\\]/g, '\\$&');
+    }
+    return new RegExp(`^${out}$`);
+}
+function walk(root, rel, into, skip) {
+    for (const entry of readdirSync(join(root, rel), { withFileTypes: true })) {
+        const path = rel ? `${rel}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+            if (!skip.has(entry.name) && !skip.has(path))
+                walk(root, path, into, skip);
+        }
+        else if (entry.isFile())
+            into.push(path);
+    }
+}
+/** Default globs: source files under the app root, minus dependency, cache and test-tool folders. */
+export function defaultSourceGlobs() {
+    return [`**/*.{${DEFAULT_EXTENSIONS.join(',')}}`];
+}
+export function expandSources(root, globs, extraSkip = []) {
+    const files = [];
+    walk(root, '', files, new Set([...SKIP_DIRS, ...extraSkip]));
+    const patterns = globs.map(globToRegExp);
+    const matched = files.filter((file) => patterns.some((pattern) => pattern.test(file))).sort();
+    if (matched.length === 0)
+        throw new Blocked([{ code: 'no_source_files', detail: `app.sources ${JSON.stringify(globs)} matched no files under ${root}`, owner: 'test author', action: 'set app.sources to the files that make up the app' }]);
+    if (matched.length > MAX_SOURCE_FILES)
+        throw new Blocked([{ code: 'too_many_source_files', detail: `app.sources matched ${matched.length} files; the attestation holds at most ${MAX_SOURCE_FILES}`, owner: 'test author', action: 'narrow app.sources, e.g. [app/**/*.py]' }]);
+    return matched;
+}
+//# sourceMappingURL=sources.js.map

package/dist/authoring/sources.js.map

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

package/dist/authoring/status.d.ts

@@ -0,0 +1,48 @@
+import { type TestRunReport } from './run.ts';
+export type NextAction = {
+    command: string;
+    why: string;
+};
+export type ProjectStatus = {
+    schemaVersion: 'tracegrove.status/v1';
+    root: string;
+    config: {
+        found: boolean;
+        path: string;
+        project: string | null;
+        adapter: string | null;
+    };
+    flows: number;
+    check: {
+        ok: boolean;
+        issues: number;
+        first: string | null;
+    };
+    latestRun: {
+        name: string;
+        outcome: string;
+        totals: TestRunReport['totals'];
+        finishedAt: string;
+        failing: string[];
+    } | null;
+    agent: {
+        provider: string;
+        model: string | null;
+        installed: boolean;
+    };
+    coverage: {
+        routes: number;
+        uncovered: number;
+        changed: number;
+    } | null;
+    latestHeal: {
+        id: string;
+        outcome: string;
+        kept: number;
+    } | null;
+    next: NextAction[];
+};
+/** Walk up from `dir` to the folder holding tracegrove.config.yaml; null when there is none. */
+export declare function projectRoot(dir: string): string | null;
+export declare function projectStatus(dir: string): ProjectStatus;
+export declare function ageOf(iso: string, now?: number): string;

package/dist/authoring/status.js

@@ -0,0 +1,100 @@
+/**
+ * `tracegrove status`: one look at where a project stands and the next command worth running.
+ * It never starts the app. The `next` list is ordered and machine-readable so a coding agent can
+ * follow it the same way a person does.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { basename, dirname, join, resolve } from 'node:path';
+import { CONFIG_FILE, loadAuthoringConfig } from "./compile.js";
+import { resolveRun } from "./run.js";
+import { checkProject, discoverProject } from "./workspace.js";
+import { detectAgents, resolveAgentSettings } from "./agent.js";
+import { listHeals } from "./heal.js";
+/** Walk up from `dir` to the folder holding tracegrove.config.yaml; null when there is none. */
+export function projectRoot(dir) {
+    let current = resolve(dir);
+    for (;;) {
+        if (existsSync(join(current, CONFIG_FILE)))
+            return current;
+        const parent = dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+export function projectStatus(dir) {
+    const root = projectRoot(dir) ?? resolve(dir);
+    const path = join(root, CONFIG_FILE);
+    const found = existsSync(path);
+    let config = null;
+    try {
+        config = found ? loadAuthoringConfig(path) : null;
+    }
+    catch {
+        config = null;
+    }
+    const check = found ? checkProject(root) : { ok: false, flows: [], issues: [] };
+    let latestRun = null;
+    const runDir = found ? resolveRun(root, 'latest') : null;
+    if (runDir && existsSync(join(runDir, 'summary.json'))) {
+        try {
+            const r = JSON.parse(readFileSync(join(runDir, 'summary.json'), 'utf8'));
+            latestRun = { name: basename(runDir), outcome: r.outcome, totals: r.totals, finishedAt: r.finishedAt, failing: r.cases.filter((c) => c.outcome !== 'passed').map((c) => c.caseId) };
+        }
+        catch {
+            latestRun = null;
+        }
+    }
+    let settings = { provider: 'claude', model: null };
+    try {
+        settings = resolveAgentSettings(root, config);
+    }
+    catch { /* invalid settings show up in check */ }
+    const installed = settings.provider !== 'none' && !!detectAgents()[settings.provider];
+    let coverage = null;
+    if (found) {
+        try {
+            const d = discoverProject(root, null);
+            coverage = { routes: d.routes.length, uncovered: d.uncovered, changed: d.routes.filter((r) => r.changed).length };
+        }
+        catch {
+            coverage = null;
+        }
+    }
+    const heal = found ? listHeals(root)[0] : undefined;
+    const latestHeal = heal ? { id: heal.id, outcome: heal.outcome, kept: heal.changes.filter((c) => c.status === 'kept').length } : null;
+    const next = [];
+    if (!found)
+        next.push({ command: 'tracegrove init', why: 'detect the framework and write tracegrove.config.yaml plus a first flow' });
+    else if (!check.ok)
+        next.push({ command: 'tracegrove heal', why: `${check.issues.length} authoring or setup issue(s); heal fixes what it can and explains the rest` }, { command: 'tracegrove check', why: 'see every issue with its file and fix' });
+    else if (!latestRun)
+        next.push({ command: 'tracegrove test', why: 'run every flow against the real app for the first time' });
+    else if (latestRun.outcome !== 'passed')
+        next.push({ command: 'tracegrove heal', why: `${latestRun.failing.length} case(s) not passing; heal fixes setup and drifted tests and reports product bugs` }, { command: 'tracegrove show', why: 'read the failure in full' });
+    if (found && coverage && coverage.uncovered > 0)
+        next.push(installed
+            ? { command: 'tracegrove draft', why: `${coverage.uncovered} route(s) have no flow; ${settings.provider} drafts them, check verifies` }
+            : { command: 'tracegrove discover', why: `${coverage.uncovered} route(s) have no flow yet` });
+    if (found && !installed && settings.provider !== 'none')
+        next.push({ command: 'tracegrove settings', why: `${settings.provider} is not installed; agent drafting and healing are off` });
+    if (found)
+        next.push({ command: 'tracegrove ui', why: 'see the grove: flows, runs, coverage and heals in the browser' });
+    return {
+        schemaVersion: 'tracegrove.status/v1', root,
+        config: { found, path, project: config?.project ?? null, adapter: config?.app.adapter ?? null },
+        flows: check.flows.length, check: { ok: check.ok, issues: check.issues.length, first: check.issues[0] ? `${check.issues[0].code}: ${check.issues[0].detail}` : null },
+        latestRun, agent: { provider: settings.provider, model: settings.model, installed }, coverage, latestHeal, next,
+    };
+}
+export function ageOf(iso, now = Date.now()) {
+    const s = Math.max(0, Math.round((now - Date.parse(iso)) / 1000));
+    if (s < 60)
+        return `${s}s ago`;
+    if (s < 3600)
+        return `${Math.round(s / 60)}m ago`;
+    if (s < 86_400)
+        return `${Math.round(s / 3600)}h ago`;
+    return `${Math.round(s / 86_400)}d ago`;
+}
+//# sourceMappingURL=status.js.map

package/dist/authoring/status.js.map

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

package/dist/authoring/typed.d.ts

@@ -0,0 +1,6 @@
+import type { z } from 'zod';
+import type { AuthoringConfig, Fixture, Flow } from './schema.ts';
+/** Editor types only. The compiler validates all formats against the same schemas. */
+export declare function defineConfig(input: z.input<typeof AuthoringConfig>): z.input<typeof AuthoringConfig>;
+export declare function flow(input: z.input<typeof Flow>): z.input<typeof Flow>;
+export declare function fixture(input: z.input<typeof Fixture>): z.input<typeof Fixture>;

package/dist/authoring/typed.js

@@ -0,0 +1,5 @@
+/** Editor types only. The compiler validates all formats against the same schemas. */
+export function defineConfig(input) { return input; }
+export function flow(input) { return input; }
+export function fixture(input) { return input; }
+//# sourceMappingURL=typed.js.map

package/dist/authoring/typed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed.js","sourceRoot":"","sources":["../../src/authoring/typed.ts"],"names":[],"mappings":"AAGA,sFAAsF;AACtF,MAAM,UAAU,YAAY,CAAC,KAAsC,IAAqC,OAAO,KAAK,CAAC,CAAC,CAAC;AACvH,MAAM,UAAU,IAAI,CAAC,KAA2B,IAA0B,OAAO,KAAK,CAAC,CAAC,CAAC;AACzF,MAAM,UAAU,OAAO,CAAC,KAA8B,IAA6B,OAAO,KAAK,CAAC,CAAC,CAAC"}

package/dist/authoring/ui.d.ts

@@ -0,0 +1,10 @@
+export type UiServer = {
+    url: string;
+    port: number;
+    close: () => Promise<void>;
+};
+export declare function startUi(options: {
+    dir: string;
+    branch?: string | null;
+    port?: number;
+}): Promise<UiServer>;