@north-light/crouter 0.3.318 → 0.3.320

package/dist/daemon/api/handlers/profiles.js

@@ -1,140 +1 @@
-// Profile handlers (spec §6.6). Manifest-only operations share the locked
-// profile filesystem store. Deletion crosses canvas, cron, inbox, review, and
-// broker state, so it is one daemon-owned lifecycle operation.
-//
-//   PUT    /v1/profiles/:name    idempotent ensure (create-or-return)
-//   GET    /v1/profiles          list all profiles
-//   GET    /v1/profiles/:name    resolve one profile by name or id
-//   DELETE /v1/profiles/:name    required-force cascade or detach
-import { assertInstalledKind } from '../../../core/config.js';
-import { listNodesByProfile, shiftProfileNodeDeadlines } from '../../../core/canvas/canvas.js';
-import { shiftAutoBackgroundBashDeadlines } from '../../../core/bash-jobs.js';
-import { contextDir } from '../../../core/canvas/paths.js';
-import { boundFleet } from '../../../core/runtime/fleet.js';
-import { recordedPidLiveness } from '../../../core/canvas/pid.js';
-import { usage } from '../../../core/errors.js';
-import { assertProfileProjects, createProfile, ensureRootProfile, listProfiles, loadProfileManifest, pauseProfile, resumeProfile, updateProfileMetadata, } from '../../../core/profiles/manifest.js';
-import { requestProfileDeletion } from '../../profile-delete.js';
-import { toProfileDTO } from '../map.js';
-const ROOT_PROFILE_NAME = 'root';
-/** `PUT /v1/profiles/:name` — idempotent ensure. `root` maps to the singleton
- *  root profile; any other name returns the existing same-named profile if one
- *  exists (so a re-PUT yields the same id), else creates it. `default_kind`
- *  and `metadata` apply only at create — an existing profile is returned
- *  untouched; mutation stays on `crtr profile kind` / `crtr profile meta`. */
-function handleEnsure(ctx) {
-    const name = ctx.params['name'];
-    const req = (ctx.body ?? {});
-    // Shape check runs before the idempotent returns, so a legacy string array
-    // cannot slip through an ensure of root or an existing profile. Existence
-    // and realpath normalization stay create-only, so a valid entry naming a
-    // since-deleted directory still returns the existing profile.
-    if (req.projects !== undefined)
-        assertProfileProjects(req.projects);
-    if (name === ROOT_PROFILE_NAME) {
-        return { status: 200, body: toProfileDTO(ensureRootProfile()) };
-    }
-    const existing = listProfiles().find((p) => p.manifest.name === name);
-    if (existing !== undefined) {
-        return { status: 200, body: toProfileDTO(existing) };
-    }
-    // Same gate as `profile new`/`profile kind`: a persisted unknown kind would
-    // poison every future omitted-kind create under this profile.
-    if (req.default_kind !== undefined)
-        assertInstalledKind(req.default_kind);
-    const created = createProfile(name, req.projects ?? [], {
-        defaultKind: req.default_kind,
-        metadata: req.metadata,
-    });
-    return { status: 200, body: toProfileDTO(created) };
-}
-/** `PATCH /v1/profiles/:name/metadata` — merge and remove metadata entries
- * on an existing profile. Resolution accepts the profile id or unique name,
- * matching the read and delete routes; this is deliberately separate from the
- * create-only ensure route. */
-function handleSetMetadata(ctx) {
-    const profile = loadProfileManifest(ctx.params['name']);
-    const raw = ctx.body ?? {};
-    if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
-        throw usage('profile metadata body must be an object', { field: 'body' });
-    }
-    const req = raw;
-    const unset = req.unset === undefined ? [] : req.unset;
-    if (!Array.isArray(unset) || unset.some((key) => typeof key !== 'string')) {
-        throw usage('profile metadata `unset` must be an array of strings', { field: 'unset' });
-    }
-    const set = req.set === undefined ? {} : req.set;
-    const updated = updateProfileMetadata(profile.profileId, set, unset);
-    return { status: 200, body: toProfileDTO(updated) };
-}
-/** `POST /v1/profiles/:name/pause` — make the profile inert, then directly
- * SIGTERM its live brokers. This deliberately avoids host teardown: the
- * broker's SIGTERM path hands foreground bash jobs to their detached
- * supervisors, while shutdown would abort and remove them. */
-function handlePause(ctx) {
-    const profile = loadProfileManifest(ctx.params['name']);
-    const paused = pauseProfile(profile.profileId);
-    const nodes = listNodesByProfile(profile.profileId).filter((node) => node.status === 'active' || node.status === 'idle');
-    if (nodes.length === 0)
-        return { status: 200, body: { profile_id: profile.profileId, paused_at: paused.manifest.paused_at } };
-    const fleet = boundFleet();
-    for (const node of nodes) {
-        const live = fleet.get(node.node_id);
-        if (live !== undefined) {
-            fleet.interruptForProfilePause(node.node_id, live.pid);
-            continue;
-        }
-        if (node.pi_pid != null && recordedPidLiveness(node.pi_pid, node.pi_pid_identity) === 'alive') {
-            fleet.interruptForProfilePause(node.node_id, node.pi_pid);
-        }
-    }
-    return { status: 200, body: { profile_id: profile.profileId, paused_at: paused.manifest.paused_at } };
-}
-/** `POST /v1/profiles/:name/resume` — restore admission and credit active
- * profile deadlines for the interval during which the profile was inert. The
- * lifecycle tick owns broker recovery after the pause interruption settles. */
-function handleResume(ctx) {
-    const profile = loadProfileManifest(ctx.params['name']);
-    const resumed = resumeProfile(profile.profileId);
-    if (resumed.pausedAt !== null) {
-        const pausedAt = Date.parse(resumed.pausedAt);
-        if (!Number.isNaN(pausedAt)) {
-            const pausedMs = Math.max(0, Date.now() - pausedAt);
-            shiftProfileNodeDeadlines(profile.profileId, pausedMs);
-            // Background bash claim windows are the same kind of budget as a node
-            // deadline: time the node was allowed to act, not wall-clock time.
-            for (const node of listNodesByProfile(profile.profileId)) {
-                if (node.status === 'dead')
-                    continue;
-                shiftAutoBackgroundBashDeadlines(contextDir(node.node_id), pausedMs);
-            }
-        }
-    }
-    return { status: 200, body: { profile_id: profile.profileId, paused_at: resumed.manifest.paused_at } };
-}
-/** `GET /v1/profiles` — every profile with a readable manifest. */
-function handleList() {
-    return { status: 200, body: listProfiles().map(toProfileDTO) };
-}
-/** `GET /v1/profiles/:name` — resolve one profile by exact id or unique name.
- *  A miss throws `notFound` (→ 404); an ambiguous name throws `ambiguous`
- *  (→ 400) — both from the manifest resolver, mapped by `errorToStatus`. */
-function handleGet(ctx) {
-    const name = ctx.params['name'];
-    return { status: 200, body: toProfileDTO(loadProfileManifest(name)) };
-}
-/** `DELETE /v1/profiles/:name` — forced cascade by default, or forced
- *  identity detach when requested. Exact resolution, blockers, counts, broker
- *  teardown, and final manifest removal all live in the daemon lifecycle. */
-async function handleDelete(ctx) {
-    return requestProfileDeletion(ctx.params['name'], ctx.body);
-}
-export const profileRoutes = [
-    { method: 'PUT', pattern: '/v1/profiles/:name', handler: handleEnsure },
-    { method: 'POST', pattern: '/v1/profiles/:name/pause', handler: handlePause },
-    { method: 'POST', pattern: '/v1/profiles/:name/resume', handler: handleResume },
-    { method: 'PATCH', pattern: '/v1/profiles/:name/metadata', handler: handleSetMetadata },
-    { method: 'DELETE', pattern: '/v1/profiles/:name', handler: handleDelete },
-    { method: 'GET', pattern: '/v1/profiles', handler: handleList },
-    { method: 'GET', pattern: '/v1/profiles/:name', handler: handleGet },
-];
+var c=Object.defineProperty;var s=(r,e)=>c(r,"name",{value:e,configurable:!0});import{assertInstalledKind as h}from"../../../core/config.js";import{listNodesByProfile as u,shiftProfileNodeDeadlines as y}from"../../../core/canvas/canvas.js";import{shiftAutoBackgroundBashDeadlines as P}from"../../../core/bash-jobs.js";import{contextDir as _}from"../../../core/canvas/paths.js";import{boundFleet as b}from"../../../core/runtime/fleet.js";import{recordedPidLiveness as v}from"../../../core/canvas/pid.js";import{usage as p}from"../../../core/errors.js";import{assertProfileProjects as I,createProfile as A,ensureRootProfile as D,listProfiles as l,loadProfileManifest as f,pauseProfile as T,resumeProfile as E,updateProfileMetadata as g}from"../../../core/profiles/manifest.js";import{requestProfileDeletion as j}from"../../profile-delete.js";import{toProfileDTO as i}from"../map.js";const M="root";function N(r){const e=r.params.name,t=r.body??{};if(t.projects!==void 0&&I(t.projects),e===M)return{status:200,body:i(D())};const n=l().find(o=>o.manifest.name===e);if(n!==void 0)return{status:200,body:i(n)};t.default_kind!==void 0&&h(t.default_kind);const a=A(e,t.projects??[],{defaultKind:t.default_kind,metadata:t.metadata});return{status:200,body:i(a)}}s(N,"handleEnsure");function O(r){const e=f(r.params.name),t=r.body??{};if(typeof t!="object"||t===null||Array.isArray(t))throw p("profile metadata body must be an object",{field:"body"});const n=t,a=n.unset===void 0?[]:n.unset;if(!Array.isArray(a)||a.some(m=>typeof m!="string"))throw p("profile metadata `unset` must be an array of strings",{field:"unset"});const o=n.set===void 0?{}:n.set,d=g(e.profileId,o,a);return{status:200,body:i(d)}}s(O,"handleSetMetadata");function R(r){const e=f(r.params.name),t=T(e.profileId),n=u(e.profileId).filter(o=>o.status==="active"||o.status==="idle");if(n.length===0)return{status:200,body:{profile_id:e.profileId,paused_at:t.manifest.paused_at}};const a=b();for(const o of n){const d=a.get(o.node_id);if(d!==void 0){a.interruptForProfilePause(o.node_id,d.pid);continue}o.pi_pid!=null&&v(o.pi_pid,o.pi_pid_identity)==="alive"&&a.interruptForProfilePause(o.node_id,o.pi_pid)}return{status:200,body:{profile_id:e.profileId,paused_at:t.manifest.paused_at}}}s(R,"handlePause");function k(r){const e=f(r.params.name),t=E(e.profileId);if(t.pausedAt!==null){const n=Date.parse(t.pausedAt);if(!Number.isNaN(n)){const a=Math.max(0,Date.now()-n);y(e.profileId,a);for(const o of u(e.profileId))o.status!=="dead"&&P(_(o.node_id),a)}}return{status:200,body:{profile_id:e.profileId,paused_at:t.manifest.paused_at}}}s(k,"handleResume");function w(){return{status:200,body:l().map(i)}}s(w,"handleList");function F(r){const e=r.params.name;return{status:200,body:i(f(e))}}s(F,"handleGet");async function L(r){return j(r.params.name,r.body)}s(L,"handleDelete");const Q=[{method:"PUT",pattern:"/v1/profiles/:name",handler:N},{method:"POST",pattern:"/v1/profiles/:name/pause",handler:R},{method:"POST",pattern:"/v1/profiles/:name/resume",handler:k},{method:"PATCH",pattern:"/v1/profiles/:name/metadata",handler:O},{method:"DELETE",pattern:"/v1/profiles/:name",handler:L},{method:"GET",pattern:"/v1/profiles",handler:w},{method:"GET",pattern:"/v1/profiles/:name",handler:F}];export{Q as profileRoutes};

package/dist/daemon/api/handlers/prospective-chat-inventory.js

@@ -1,59 +1 @@
-import { ApiError } from '../../../api/errors.js';
-import { usage } from '../../../core/errors.js';
-import { resolveLaunchTarget } from '../../../core/runtime/launch-target.js';
-import { runProspectiveInventory } from '../../../core/runtime/prospective-inventory.js';
-const inFlight = new Map();
-function singleQueryValue(ctx, name) {
-    const values = ctx.query.getAll(name);
-    if (values.length > 1)
-        throw usage(`${name} must appear at most once`);
-    return values[0];
-}
-async function handleGet(ctx) {
-    for (const [name] of ctx.query) {
-        if (name !== 'profile' && name !== 'cwd' && name !== 'kind')
-            throw usage(`unknown prospective inventory query parameter: ${name}`);
-    }
-    const profile = singleQueryValue(ctx, 'profile');
-    const cwd = singleQueryValue(ctx, 'cwd');
-    const kind = singleQueryValue(ctx, 'kind');
-    if (kind !== undefined && kind.trim() === '')
-        throw usage('kind must be a non-empty string when provided');
-    const target = await resolveLaunchTarget({
-        root: true,
-        ...(profile !== undefined ? { profile } : {}),
-        ...(cwd !== undefined ? { cwd } : {}),
-        ...(kind !== undefined ? { kind } : {}),
-    }, { readOnlyProfileSelection: true });
-    const key = JSON.stringify([target.profileId, target.cwd, target.kind]);
-    let pending = inFlight.get(key);
-    if (pending === undefined) {
-        pending = runProspectiveInventory({
-            cwd: target.cwd,
-            profileId: target.profileId,
-            extensions: target.launch.extensions,
-        });
-        inFlight.set(key, pending);
-        void pending.finally(() => {
-            if (inFlight.get(key) === pending)
-                inFlight.delete(key);
-        }).catch(() => { });
-    }
-    let rows;
-    try {
-        rows = await pending;
-    }
-    catch {
-        throw new ApiError(503, 'preflight_failed', 'prospective chat inventory preflight failed');
-    }
-    const body = {
-        profile_id: target.profileId,
-        cwd: target.cwd,
-        commands: rows.commands,
-        memory_refs: rows.memory_refs,
-    };
-    return { status: 200, body };
-}
-export const prospectiveChatInventoryRoutes = [
-    { method: 'GET', pattern: '/v1/prospective-chat-inventory', handler: handleGet },
-];
+var u=Object.defineProperty;var a=(e,n)=>u(e,"name",{value:n,configurable:!0});import{ApiError as m}from"../../../api/errors.js";import{usage as p}from"../../../core/errors.js";import{resolveLaunchTarget as y}from"../../../core/runtime/launch-target.js";import{runProspectiveInventory as h}from"../../../core/runtime/prospective-inventory.js";const c=new Map;function l(e,n){const o=e.query.getAll(n);if(o.length>1)throw p(`${n} must appear at most once`);return o[0]}a(l,"singleQueryValue");async function w(e){for(const[s]of e.query)if(s!=="profile"&&s!=="cwd"&&s!=="kind")throw p(`unknown prospective inventory query parameter: ${s}`);const n=l(e,"profile"),o=l(e,"cwd"),i=l(e,"kind");if(i!==void 0&&i.trim()==="")throw p("kind must be a non-empty string when provided");const t=await y({root:!0,...n!==void 0?{profile:n}:{},...o!==void 0?{cwd:o}:{},...i!==void 0?{kind:i}:{}},{readOnlyProfileSelection:!0}),d=JSON.stringify([t.profileId,t.cwd,t.kind]);let r=c.get(d);r===void 0&&(r=h({cwd:t.cwd,profileId:t.profileId,extensions:t.launch.extensions}),c.set(d,r),r.finally(()=>{c.get(d)===r&&c.delete(d)}).catch(()=>{}));let f;try{f=await r}catch{throw new m(503,"preflight_failed","prospective chat inventory preflight failed")}return{status:200,body:{profile_id:t.profileId,cwd:t.cwd,commands:f.commands,memory_refs:f.memory_refs}}}a(w,"handleGet");const q=[{method:"GET",pattern:"/v1/prospective-chat-inventory",handler:w}];export{q as prospectiveChatInventoryRoutes};

package/dist/daemon/api/handlers/reports.js

@@ -1,332 +1,16 @@
-// Report handlers (spec §6.4, §7.4). `POST /nodes/{id}/reports` is the single
-// push route — `tier` is the report kind and update-only `delivery_tier` sets
-// subscriber delivery urgency; `final` drives the server-side lifecycle
-// transition inside feed `push()` (the sanctioned path). `GET
-// /nodes/{id}/reports` lists the node's stored report files. `POST
-// /nodes/{id}/result` submits a structured result against the node's pending
-// output schema (`crtr push result`): validate → write context/result.json →
-// push the mode-matched report → clear the schema — or declines it
-// (`--decline --code [--retryable]`): write context/declined.json → push the
-// same report shape carrying a `failure`/`declined` outcome whose detail holds
-// the reason, code, and retryable flag → clear the schema.
-//
-// `{id}` is the REPORTING node (client-side = CRTR_NODE_ID).
-import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
-import { join } from 'node:path';
-import { getNode } from '../../../core/canvas/canvas.js';
-import { push, FinalizationError } from '../../../core/feed/feed.js';
-import { branchIsPushedAtCurrentTip, hasOpenManagedWorktree, missingWorktreeRecoveryHint } from '../../../core/worktree.js';
-import { autoDropCleanManagedWorktreeAsync } from '../../../core/worktree-mutation-async.js';
-import { reportsDir } from '../../../core/canvas/paths.js';
-import { notFound, usage } from '../../../core/errors.js';
-import { InputError } from '../../../core/io.js';
-import { parseFrontmatterGeneric } from '../../../core/frontmatter.js';
-import { toReportResultDTO } from '../map.js';
-import { outputSchemaPath, readOutputRequest, removeOutputSchema, validateStructuredResult, writeOutputDeclined, writeOutputResult, } from '../../../core/runtime/structured-output.js';
-function requireNode(id) {
-    if (getNode(id) === null)
-        throw notFound(`unknown node: ${id}`, { received: id });
-}
-/** Validate + narrow the push body (spec §7.4). */
-function parsePushBody(body) {
-    if (typeof body !== 'object' || body === null) {
-        throw usage('a push report requires a JSON body { tier, body }');
-    }
-    const tier = body.tier;
-    const deliveryTier = body.delivery_tier;
-    const text = body.body;
-    if (tier !== 'update' && tier !== 'urgent' && tier !== 'final') {
-        throw usage(`invalid report tier: ${String(tier)} (expected update|urgent|final)`);
-    }
-    if (deliveryTier !== undefined && deliveryTier !== 'deferred' && deliveryTier !== 'normal' && deliveryTier !== 'urgent') {
-        throw usage(`invalid delivery_tier: ${String(deliveryTier)} (expected deferred|normal|urgent)`);
-    }
-    if (tier !== 'update' && deliveryTier !== undefined) {
-        throw usage('delivery_tier is only valid for update reports');
-    }
-    if (typeof text !== 'string' || text.trim() === '') {
-        throw usage('a push report requires a non-empty body');
-    }
-    return { tier, ...(deliveryTier === undefined ? {} : { delivery_tier: deliveryTier }), body: text };
-}
-async function handlePush(ctx) {
-    const id = ctx.params['id'];
-    requireNode(id);
-    const req = parsePushBody(ctx.body);
-    // A valid pending structured-output request means this node owes a
-    // schema-checked result — a plain `push final` would finish it with
-    // context/result.json never written (the stop guard honors `pushedFinal`
-    // before its structured-output check, so it cannot catch this). An INVALID
-    // request file deliberately does NOT block: the stop guard's prescribed
-    // manual-cleanup escape (`push final` after removing the corrupt file, or
-    // despite it) must stay reachable.
-    if (req.tier === 'final' && readOutputRequest(id).state === 'valid') {
-        throw new InputError({
-            error: 'structured_result_pending',
-            message: 'This node owes a structured result — a plain `push final` would finish it without recording one.',
-            next: 'Submit the result with `crtr push result` instead; it validates against the pending schema, records it, and pushes the final report for you. If the schema cannot be honestly satisfied, `crtr push result --decline "<reason>" --code <token>` records the decline and finishes the node.',
-        });
-    }
-    // `final` flips the node to done inside push() (commitCanonicalFinal). Capture
-    // the pre-push status so the DTO can report the transition (spec §7.4).
-    const before = req.tier === 'final' ? getNode(id)?.status : undefined;
-    const autoDroppedPath = req.tier === 'final' ? await guardFinalWorktree(id) : undefined;
-    const result = await pushOrRethrow(id, req);
-    const transitioned = req.tier === 'final' && before !== undefined
-        ? { from: before, to: getNode(id)?.status ?? 'done' }
-        : undefined;
-    return { status: 200, body: toReportResultDTO(result, transitioned, autoDroppedPath) };
-}
-/** The `final`-path managed-worktree guard, BEFORE the push/transition (spec
- *  §6.2 — worktree fs ops are server-side). A provably-clean, zero-commit
- *  worktree is auto-dropped so a read-only or already-landed node
- *  can finish without an explicit `node worktree close`; a clean worktree
- *  whose exact tip is already on origin can also finish while retaining its
- *  branch and checkout. Any work that is neither locally landed nor remotely
- *  retained instead blocks with the parity `open_managed_worktree` error,
- *  round-tripped via CrtrError.details so the CLI renders the same InputError
- *  (next-hint included) it surfaced before B-5 re-homed this to the server.
- *  Returns the auto-dropped checkout path, or undefined when nothing dropped. */
-async function guardFinalWorktree(id) {
-    if (!hasOpenManagedWorktree(getNode(id)))
-        return undefined;
-    const dropped = await autoDropCleanManagedWorktreeAsync(id);
-    if (dropped !== null)
-        return dropped.worktree_path;
-    if (await branchIsPushedAtCurrentTip(getNode(id).managed_worktree))
-        return undefined;
-    // Thrown as InputError so `toErrorBody` round-trips the FULL structured
-    // payload (code + message + next) into `ApiError.details`, and the CLI's
-    // shared `apiErrorToCliError` reconstructs it byte-for-byte — no
-    // command-local mapper needed (plan C-5).
-    throw new InputError({
-        error: 'open_managed_worktree',
-        message: 'This node still owns an open managed worktree that is neither clean and locally landed nor clean with its exact tip on origin — `push final` cannot finish.',
-        next: (() => {
-            const wt = getNode(id)?.managed_worktree;
-            return wt !== null && wt !== undefined && wt.state === 'open' && !existsSync(wt.path)
-                ? missingWorktreeRecoveryHint(wt)
-                : 'Commit the remaining work in the worktree, push its branch to origin at its current tip, then rerun `crtr push final`; or run `crtr node worktree close` to land it locally.';
-        })(),
-    });
-}
-/** Cap on the fenced-JSON echo inside the submit report body. The full result
- *  is always on disk at result_path; the report only needs enough to orient. */
-const REPORT_JSON_ECHO_LIMIT = 2000;
-function submitReportBody(resultPath, value) {
-    const json = JSON.stringify(value, null, 2);
-    const fenced = json.length > REPORT_JSON_ECHO_LIMIT
-        ? `${json.slice(0, REPORT_JSON_ECHO_LIMIT)}\n… (truncated — the full result is at the result path above)`
-        : json;
-    return `Structured output submitted.\n\nResult path: ${resultPath}\n\n\`\`\`json\n${fenced}\n\`\`\`\n`;
-}
-function declineReportBody(declinedPath, declined) {
-    return `Structured result declined.\n\nReason: ${declined.reason}\nCode: ${declined.code}\nRetryable: ${declined.retryable ? 'yes' : 'no'}\n\nDeclined marker: ${declinedPath}\n`;
-}
-/** A decline reason is one sentence for a human or a consumer to read, not a payload. */
-const DECLINE_REASON_MAX_CHARS = 1024;
-/** A decline code is one token the requester classifies on, not a message. */
-const DECLINE_CODE_MAX_CHARS = 64;
-/** Narrow the submit body to exactly one of `{ value }` or `{ decline, code, retryable }`. */
-function parseSubmitBody(body) {
-    if (typeof body !== 'object' || body === null) {
-        throw usage('a result submission requires a JSON body { value } or { decline, code, retryable }');
-    }
-    const hasValue = Object.hasOwn(body, 'value');
-    const hasDecline = Object.hasOwn(body, 'decline');
-    if (hasValue && hasDecline)
-        throw usage('a result submission carries either { value } or { decline, code, retryable }, not both');
-    if (hasDecline) {
-        const { decline, code, retryable } = body;
-        if (typeof decline !== 'string' || decline.trim() === '') {
-            throw new InputError({
-                error: 'missing_decline_reason',
-                message: 'A decline needs a reason.',
-                next: 'Rerun with `--decline "<one sentence on why the schema cannot be honestly satisfied>" --code <token>`.',
-            });
-        }
-        if (decline.length > DECLINE_REASON_MAX_CHARS) {
-            throw new InputError({
-                error: 'decline_reason_too_long',
-                message: `A decline reason is at most ${DECLINE_REASON_MAX_CHARS} characters (got ${decline.length}).`,
-                next: 'Keep the reason to one plain sentence; put any detail in an artifact and name its path.',
-            });
-        }
-        if (typeof code !== 'string' || code.trim() === '' || /\s/.test(code.trim()) || code.trim().length > DECLINE_CODE_MAX_CHARS) {
-            throw new InputError({
-                error: 'invalid_decline_code',
-                message: `A decline needs a code: one whitespace-free token of at most ${DECLINE_CODE_MAX_CHARS} characters naming the decline class.`,
-                next: 'Rerun with `--code <token>` — the token your requester documented for this case.',
-            });
-        }
-        if (typeof retryable !== 'boolean') {
-            throw usage('a decline carries `retryable` as a boolean');
-        }
-        return { declined: { reason: decline.trim(), code: code.trim(), retryable } };
-    }
-    if (!hasValue) {
-        // `value` must be PRESENT — but any JSON value, including null, is a legal
-        // result to validate, so presence is checked rather than truthiness.
-        throw usage('a result submission requires a JSON body { value } or { decline, code, retryable }');
-    }
-    return { value: body.value };
-}
-/** `POST /v1/nodes/{id}/result` — submit a structured result (`crtr push
- *  result`). Validate against the pending schema, write context/result.json
- *  atomically, push the mode-matched report (final for terminal, update for
- *  oneoff), then clear the schema. Any failure before the schema removal leaves
- *  the request in place, so the submit stays retryable. */
-async function handleSubmitResult(ctx) {
-    const id = ctx.params['id'];
-    requireNode(id);
-    const submitted = parseSubmitBody(ctx.body);
-    const state = readOutputRequest(id);
-    if (state.state === 'absent') {
-        throw new InputError({
-            error: 'no_output_request',
-            message: 'No structured output is currently requested of this node.',
-            next: 'Nothing to submit here — continue working, or finish with `crtr push final`.',
-        });
-    }
-    if (state.state === 'invalid') {
-        throw new InputError({
-            error: 'invalid_output_request',
-            message: `The structured-output request file is invalid: ${state.error}`,
-            next: `Have the requester re-issue the request, or remove ${outputSchemaPath(id)} and finish with \`crtr push final\`.`,
-        });
-    }
-    const { mode, schema } = state.request;
-    let validated;
-    if ('value' in submitted) {
-        try {
-            validated = await validateStructuredResult(schema, submitted.value);
-        }
-        catch (err) {
-            // Schema retained — the node fixes the listed fields and resubmits.
-            throw new InputError({
-                error: 'result_schema_mismatch',
-                message: `the submitted result does not match the requested schema: ${err.message}`,
-                next: 'Fix the listed fields and rerun `crtr push result`; if the schema cannot be honestly satisfied, rerun with `--decline "<reason>" --code <token>`.',
-            });
-        }
-    }
-    const before = mode === 'terminal' ? getNode(id)?.status : undefined;
-    const autoDroppedPath = mode === 'terminal' ? await guardFinalWorktree(id) : undefined;
-    let resultPath;
-    let reportBody;
-    let outcome;
-    if ('declined' in submitted) {
-        const { declined } = submitted;
-        resultPath = writeOutputDeclined(id, { mode, ...declined, at: new Date().toISOString() });
-        reportBody = declineReportBody(resultPath, declined);
-        // A one-off decline is an update report, not the canonical final: no outcome to record.
-        if (mode === 'terminal') {
-            const detail = { schema: 'crtr.node-outcome-detail/v1', message: declined.reason, declined };
-            outcome = { kind: 'failure', reason: 'declined', detailJson: JSON.stringify(detail) };
-        }
-    }
-    else {
-        resultPath = writeOutputResult(id, validated);
-        reportBody = submitReportBody(resultPath, validated);
-    }
-    const pushed = await pushOrRethrow(id, {
-        tier: mode === 'terminal' ? 'final' : 'update',
-        body: reportBody,
-    }, outcome);
-    removeOutputSchema(id);
-    const transitioned = mode === 'terminal' && before !== undefined
-        ? { from: before, to: getNode(id)?.status ?? 'done' }
-        : undefined;
-    const body = {
-        mode,
-        result_path: resultPath,
-        report_path: pushed.reportPath,
-        notified: [...pushed.deliveredTo],
-        ...('declined' in submitted ? { declined: submitted.declined } : {}),
-        ...(transitioned === undefined ? {} : { transitioned }),
-        ...(autoDroppedPath === undefined
-            ? {}
-            : { worktree_auto_dropped: true, worktree_auto_dropped_path: autoDroppedPath }),
-    };
-    return { status: 200, body };
-}
-/** `push()` but with the finalization guards translated to the same structured
- *  `InputError` the pre-API `crtr push` verb surfaced. Feed throws a bare
- *  `FinalizationError` (its `.message` is just the code); rethrowing as
- *  `InputError` round-trips the SPECIFIC code + a clean message + next through
- *  `ApiError.details`, so the shared CLI mapper reconstructs it verbatim and
- *  the agent-facing `already_finalized`/`finalization_forbidden` contract
- *  survives (a bare 409 would otherwise collapse to the generic `conflict`
- *  code). `unknown_node` is unreachable here (`requireNode` guards above), so
- *  it falls through as the generic 404. */
-async function pushOrRethrow(id, req, outcome) {
-    try {
-        return await push(id, { kind: req.tier, body: req.body, ...(req.delivery_tier === undefined ? {} : { deliveryTier: req.delivery_tier }), ...(outcome === undefined ? {} : { outcome }) });
-    }
-    catch (err) {
-        if (err instanceof FinalizationError && err.code === 'already_finalized') {
-            throw new InputError({
-                error: 'already_finalized',
-                message: 'This node already submitted its canonical final result.',
-                next: 'Push an update with the new information, then stop.',
-            });
-        }
-        if (err instanceof FinalizationError && err.code === 'finalization_forbidden') {
-            throw new InputError({
-                error: 'finalization_forbidden',
-                message: 'A canceled or dead node cannot submit a canonical final result.',
-                next: 'Do not push final from this node.',
-            });
-        }
-        throw err;
-    }
-}
-/** Compact report stamp `20260607T075536` → ISO `2026-06-07T07:55:36`. */
-function compactToIso(stamp) {
-    const m = stamp.match(/^(\d{4})(\d{2})(\d{2})T(\d{2})(\d{2})(\d{2})$/);
-    return m === null ? stamp : `${m[1]}-${m[2]}-${m[3]}T${m[4]}:${m[5]}:${m[6]}`;
-}
-/** Read one node's pushed reports, newest first. This stays in the daemon so
- * collection projections can include report activity without client-side N+1s. */
-export function reportsForNode(id) {
-    const dir = reportsDir(id);
-    let files;
-    try {
-        files = readdirSync(dir).filter((f) => f.endsWith('.md'));
-    }
-    catch {
-        files = [];
-    }
-    const reports = [];
-    for (const f of files) {
-        const abs = join(dir, f);
-        const raw = readFileSync(abs, 'utf8');
-        const { data, body } = parseFrontmatterGeneric(raw);
-        const m = f.match(/^([0-9]{8}T[0-9]{6})-(\w+)\.md$/);
-        const tier = ((typeof data?.['kind'] === 'string' ? data['kind'] : undefined) ??
-            (m ? m[2] : 'update'));
-        const created = (typeof data?.['ts'] === 'string' ? data['ts'] : undefined) ??
-            (m ? compactToIso(m[1]) : new Date(statSync(abs).mtimeMs).toISOString());
-        reports.push({ path: abs, tier, body: body.trim(), created });
-    }
-    reports.sort((a, b) => (a.created < b.created ? 1 : a.created > b.created ? -1 : 0));
-    return reports;
-}
-function handleList(ctx) {
-    const id = ctx.params['id'];
-    requireNode(id);
-    const tierFilter = ctx.query.get('tier');
-    const limitRaw = ctx.query.get('limit');
-    const limit = limitRaw !== null ? Number(limitRaw) : undefined;
-    let out = reportsForNode(id);
-    if (tierFilter !== null)
-        out = out.filter((report) => report.tier === tierFilter);
-    if (limit !== undefined && Number.isFinite(limit) && limit >= 0)
-        out = out.slice(0, limit);
-    return { status: 200, body: out };
-}
-export const reportRoutes = [
-    { method: 'POST', pattern: '/v1/nodes/:id/reports', handler: handlePush },
-    { method: 'GET', pattern: '/v1/nodes/:id/reports', handler: handleList },
-    { method: 'POST', pattern: '/v1/nodes/:id/result', handler: handleSubmitResult },
-];
+var N=Object.defineProperty;var s=(t,e)=>N(t,"name",{value:e,configurable:!0});import{existsSync as q,readdirSync as x,readFileSync as D,statSync as P}from"node:fs";import{join as A}from"node:path";import{getNode as c}from"../../../core/canvas/canvas.js";import{push as E,FinalizationError as _}from"../../../core/feed/feed.js";import{branchIsPushedAtCurrentTip as C,hasOpenManagedWorktree as I,missingWorktreeRecoveryHint as F}from"../../../core/worktree.js";import{autoDropCleanManagedWorktreeAsync as j}from"../../../core/worktree-mutation-async.js";import{reportsDir as J}from"../../../core/canvas/paths.js";import{notFound as M,usage as l}from"../../../core/errors.js";import{InputError as d}from"../../../core/io.js";import{parseFrontmatterGeneric as z}from"../../../core/frontmatter.js";import{toReportResultDTO as B}from"../map.js";import{outputSchemaPath as H,readOutputRequest as v,removeOutputSchema as W,validateStructuredResult as L,writeOutputDeclined as G,writeOutputResult as X}from"../../../core/runtime/structured-output.js";function y(t){if(c(t)===null)throw M(`unknown node: ${t}`,{received:t})}s(y,"requireNode");function K(t){if(typeof t!="object"||t===null)throw l("a push report requires a JSON body { tier, body }");const e=t.tier,n=t.delivery_tier,r=t.body;if(e!=="update"&&e!=="urgent"&&e!=="final")throw l(`invalid report tier: ${String(e)} (expected update|urgent|final)`);if(n!==void 0&&n!=="deferred"&&n!=="normal"&&n!=="urgent")throw l(`invalid delivery_tier: ${String(n)} (expected deferred|normal|urgent)`);if(e!=="update"&&n!==void 0)throw l("delivery_tier is only valid for update reports");if(typeof r!="string"||r.trim()==="")throw l("a push report requires a non-empty body");return{tier:e,...n===void 0?{}:{delivery_tier:n},body:r}}s(K,"parsePushBody");async function V(t){const e=t.params.id;y(e);const n=K(t.body);if(n.tier==="final"&&v(e).state==="valid")throw new d({error:"structured_result_pending",message:"This node owes a structured result \u2014 a plain `push final` would finish it without recording one.",next:'Submit the result with `crtr push result` instead; it validates against the pending schema, records it, and pushes the final report for you. If the schema cannot be honestly satisfied, `crtr push result --decline "<reason>" --code <token>` records the decline and finishes the node.'});const r=n.tier==="final"?c(e)?.status:void 0,i=n.tier==="final"?await S(e):void 0,o=await R(e,n),u=n.tier==="final"&&r!==void 0?{from:r,to:c(e)?.status??"done"}:void 0;return{status:200,body:B(o,u,i)}}s(V,"handlePush");async function S(t){if(!I(c(t)))return;const e=await j(t);if(e!==null)return e.worktree_path;if(!await C(c(t).managed_worktree))throw new d({error:"open_managed_worktree",message:"This node still owns an open managed worktree that is neither clean and locally landed nor clean with its exact tip on origin \u2014 `push final` cannot finish.",next:(()=>{const n=c(t)?.managed_worktree;return n!=null&&n.state==="open"&&!q(n.path)?F(n):"Commit the remaining work in the worktree, push its branch to origin at its current tip, then rerun `crtr push final`; or run `crtr node worktree close` to land it locally."})()})}s(S,"guardFinalWorktree");const k=2e3;function Q(t,e){const n=JSON.stringify(e,null,2),r=n.length>k?`${n.slice(0,k)}
+\u2026 (truncated \u2014 the full result is at the result path above)`:n;return`Structured output submitted.
+
+Result path: ${t}
+
+\`\`\`json
+${r}
+\`\`\`
+`}s(Q,"submitReportBody");function U(t,e){return`Structured result declined.
+
+Reason: ${e.reason}
+Code: ${e.code}
+Retryable: ${e.retryable?"yes":"no"}
+
+Declined marker: ${t}
+`}s(U,"declineReportBody");const O=1024,$=64;function Y(t){if(typeof t!="object"||t===null)throw l("a result submission requires a JSON body { value } or { decline, code, retryable }");const e=Object.hasOwn(t,"value"),n=Object.hasOwn(t,"decline");if(e&&n)throw l("a result submission carries either { value } or { decline, code, retryable }, not both");if(n){const{decline:r,code:i,retryable:o}=t;if(typeof r!="string"||r.trim()==="")throw new d({error:"missing_decline_reason",message:"A decline needs a reason.",next:'Rerun with `--decline "<one sentence on why the schema cannot be honestly satisfied>" --code <token>`.'});if(r.length>O)throw new d({error:"decline_reason_too_long",message:`A decline reason is at most ${O} characters (got ${r.length}).`,next:"Keep the reason to one plain sentence; put any detail in an artifact and name its path."});if(typeof i!="string"||i.trim()===""||/\s/.test(i.trim())||i.trim().length>$)throw new d({error:"invalid_decline_code",message:`A decline needs a code: one whitespace-free token of at most ${$} characters naming the decline class.`,next:"Rerun with `--code <token>` \u2014 the token your requester documented for this case."});if(typeof o!="boolean")throw l("a decline carries `retryable` as a boolean");return{declined:{reason:r.trim(),code:i.trim(),retryable:o}}}if(!e)throw l("a result submission requires a JSON body { value } or { decline, code, retryable }");return{value:t.value}}s(Y,"parseSubmitBody");async function Z(t){const e=t.params.id;y(e);const n=Y(t.body),r=v(e);if(r.state==="absent")throw new d({error:"no_output_request",message:"No structured output is currently requested of this node.",next:"Nothing to submit here \u2014 continue working, or finish with `crtr push final`."});if(r.state==="invalid")throw new d({error:"invalid_output_request",message:`The structured-output request file is invalid: ${r.error}`,next:`Have the requester re-issue the request, or remove ${H(e)} and finish with \`crtr push final\`.`});const{mode:i,schema:o}=r.request;let u;if("value"in n)try{u=await L(o,n.value)}catch(f){throw new d({error:"result_schema_mismatch",message:`the submitted result does not match the requested schema: ${f.message}`,next:'Fix the listed fields and rerun `crtr push result`; if the schema cannot be honestly satisfied, rerun with `--decline "<reason>" --code <token>`.'})}const h=i==="terminal"?c(e)?.status:void 0,p=i==="terminal"?await S(e):void 0;let a,m,w;if("declined"in n){const{declined:f}=n;if(a=G(e,{mode:i,...f,at:new Date().toISOString()}),m=U(a,f),i==="terminal"){const T={schema:"crtr.node-outcome-detail/v1",message:f.reason,declined:f};w={kind:"failure",reason:"declined",detailJson:JSON.stringify(T)}}}else a=X(e,u),m=Q(a,u);const g=await R(e,{tier:i==="terminal"?"final":"update",body:m},w);W(e);const b=i==="terminal"&&h!==void 0?{from:h,to:c(e)?.status??"done"}:void 0;return{status:200,body:{mode:i,result_path:a,report_path:g.reportPath,notified:[...g.deliveredTo],..."declined"in n?{declined:n.declined}:{},...b===void 0?{}:{transitioned:b},...p===void 0?{}:{worktree_auto_dropped:!0,worktree_auto_dropped_path:p}}}}s(Z,"handleSubmitResult");async function R(t,e,n){try{return await E(t,{kind:e.tier,body:e.body,...e.delivery_tier===void 0?{}:{deliveryTier:e.delivery_tier},...n===void 0?{}:{outcome:n}})}catch(r){throw r instanceof _&&r.code==="already_finalized"?new d({error:"already_finalized",message:"This node already submitted its canonical final result.",next:"Push an update with the new information, then stop."}):r instanceof _&&r.code==="finalization_forbidden"?new d({error:"finalization_forbidden",message:"A canceled or dead node cannot submit a canonical final result.",next:"Do not push final from this node."}):r}}s(R,"pushOrRethrow");function ee(t){const e=t.match(/^(\d{4})(\d{2})(\d{2})T(\d{2})(\d{2})(\d{2})$/);return e===null?t:`${e[1]}-${e[2]}-${e[3]}T${e[4]}:${e[5]}:${e[6]}`}s(ee,"compactToIso");function te(t){const e=J(t);let n;try{n=x(e).filter(i=>i.endsWith(".md"))}catch{n=[]}const r=[];for(const i of n){const o=A(e,i),u=D(o,"utf8"),{data:h,body:p}=z(u),a=i.match(/^([0-9]{8}T[0-9]{6})-(\w+)\.md$/),m=(typeof h?.kind=="string"?h.kind:void 0)??(a?a[2]:"update"),w=(typeof h?.ts=="string"?h.ts:void 0)??(a?ee(a[1]):new Date(P(o).mtimeMs).toISOString());r.push({path:o,tier:m,body:p.trim(),created:w})}return r.sort((i,o)=>i.created<o.created?1:i.created>o.created?-1:0),r}s(te,"reportsForNode");function ne(t){const e=t.params.id;y(e);const n=t.query.get("tier"),r=t.query.get("limit"),i=r!==null?Number(r):void 0;let o=te(e);return n!==null&&(o=o.filter(u=>u.tier===n)),i!==void 0&&Number.isFinite(i)&&i>=0&&(o=o.slice(0,i)),{status:200,body:o}}s(ne,"handleList");const ye=[{method:"POST",pattern:"/v1/nodes/:id/reports",handler:V},{method:"GET",pattern:"/v1/nodes/:id/reports",handler:ne},{method:"POST",pattern:"/v1/nodes/:id/result",handler:Z}];export{ye as reportRoutes,te as reportsForNode};