@north-light/crouter 0.3.318 → 0.3.320

package/dist/commands/dashboard.js

@@ -1,85 +1 @@
-// `crtr canvas dashboard` — canvas-wide visibility surface.
-//
-// Renders the subscription sub-DAG as an ASCII tree, optionally scoped to a
-// single root.  A human operator pastes the output into a terminal or pipes it
-// to a renderer; a machine consumer reads the structured `rows` array.
-//
-// Exported as a leaf; `crtr canvas` (canvas.ts) mounts it.
-import { defineLeaf } from '../core/command.js';
-import { InputError } from '../core/io.js';
-import { cliCanvasSource } from './api-client.js';
-import { renderTreeFromSource, renderForestFromSource, dashboardRowsFromSource, dashboardRowsAllFromSource, enrichRowsFromSource, } from '../core/canvas/render-source.js';
-// dashboard show — the main leaf
-export const dashboardLeaf = defineLeaf({
-    name: 'dashboard',
-    description: 'render the canvas as a subscription tree',
-    whenToUse: 'you want the whole graph at a glance as a rendered tree — the subscription forest drawn in ASCII so you can read its SHAPE: who reports to whom, how deep each branch runs, plus each node\'s status and context size. Scope to one root or show the full forest. Use `node inspect list` instead for a flat roster without the tree, `node inspect show` to drill into one node\'s neighbors, and `canvas attention` to find which nodes are blocked on the user',
-    help: {
-        name: 'canvas dashboard',
-        summary: 'render the canvas as an ASCII subscription tree — scoped to a root or the full forest',
-        params: [
-            {
-                kind: 'flag',
-                name: 'root',
-                type: 'string',
-                required: false,
-                constraint: 'Node id to use as the tree root. Omit for the full forest (all canvas roots).',
-            },
-        ],
-        output: [
-            { name: 'tree', type: 'string', required: true, constraint: 'Multi-line ASCII tree.' },
-            { name: 'nodes', type: 'integer', required: true, constraint: 'Total node count in this view.' },
-            { name: 'rows', type: 'object[]', required: true, constraint: 'One per node: {node_id,name,status,kind,mode,ctx_tokens,asks}.' },
-        ],
-        outputKind: 'object',
-        effects: ['Read-only: queries canvas.db and node telemetry files.'],
-    },
-    run: async (input) => {
-        const rootId = input['root'];
-        const source = cliCanvasSource();
-        const allNodes = await source.listNodes();
-        if (rootId !== undefined) {
-            if (!allNodes.some((node) => node.node_id === rootId)) {
-                throw new InputError({
-                    error: 'not_found',
-                    message: `no node: ${rootId}`,
-                    next: 'List nodes with `crtr node inspect list` to find a valid id.',
-                });
-            }
-            let asks = {};
-            let ticketsUnavailable;
-            try {
-                asks = await source.ticketCountsForView(rootId);
-            }
-            catch (err) {
-                ticketsUnavailable = err instanceof Error ? err.message : String(err);
-            }
-            const rows = await dashboardRowsFromSource(source, rootId, allNodes, asks);
-            return {
-                tree: await renderTreeFromSource(source, rootId, allNodes, asks, ticketsUnavailable),
-                nodes: rows.length,
-                rows,
-            };
-        }
-        // Full forest: all nodes on the canvas.
-        // dashboardRowsAllFromSource is the cheap-boot builder: ctx_tokens/asks are 0
-        // and `name` is the handle only until enriched. The JSON consumer wants the
-        // real values, so fold the deferred fields in before emitting (the rendered
-        // TREE is unaffected). Ask counts are per-node: attention follows each human
-        // bridge's parent relation, so fetch all displayed counts in one batch.
-        const rows = await dashboardRowsAllFromSource(source, new Set(), false, allNodes);
-        let asks = {};
-        try {
-            asks = await source.ticketCountsForNodes(allNodes.map((node) => node.node_id));
-        }
-        catch {
-            // Ticket counts decorate the dashboard; the source snapshot remains authoritative.
-        }
-        await enrichRowsFromSource(source, rows, asks);
-        return {
-            tree: await renderForestFromSource(source, allNodes, asks),
-            nodes: allNodes.length,
-            rows,
-        };
-    },
-});
+var l=Object.defineProperty;var u=(s,e)=>l(s,"name",{value:e,configurable:!0});import{defineLeaf as h}from"../core/command.js";import{InputError as m}from"../core/io.js";import{cliCanvasSource as w}from"./api-client.js";import{renderTreeFromSource as f,renderForestFromSource as p,dashboardRowsFromSource as b,dashboardRowsAllFromSource as S,enrichRowsFromSource as g}from"../core/canvas/render-source.js";const C=h({name:"dashboard",description:"render the canvas as a subscription tree",whenToUse:"you want the whole graph at a glance as a rendered tree \u2014 the subscription forest drawn in ASCII so you can read its SHAPE: who reports to whom, how deep each branch runs, plus each node's status and context size. Scope to one root or show the full forest. Use `node inspect list` instead for a flat roster without the tree, `node inspect show` to drill into one node's neighbors, and `canvas attention` to find which nodes are blocked on the user",help:{name:"canvas dashboard",summary:"render the canvas as an ASCII subscription tree \u2014 scoped to a root or the full forest",params:[{kind:"flag",name:"root",type:"string",required:!1,constraint:"Node id to use as the tree root. Omit for the full forest (all canvas roots)."}],output:[{name:"tree",type:"string",required:!0,constraint:"Multi-line ASCII tree."},{name:"nodes",type:"integer",required:!0,constraint:"Total node count in this view."},{name:"rows",type:"object[]",required:!0,constraint:"One per node: {node_id,name,status,kind,mode,ctx_tokens,asks}."}],outputKind:"object",effects:["Read-only: queries canvas.db and node telemetry files."]},run:u(async s=>{const e=s.root,t=w(),o=await t.listNodes();if(e!==void 0){if(!o.some(n=>n.node_id===e))throw new m({error:"not_found",message:`no node: ${e}`,next:"List nodes with `crtr node inspect list` to find a valid id."});let r={},d;try{r=await t.ticketCountsForView(e)}catch(n){d=n instanceof Error?n.message:String(n)}const c=await b(t,e,o,r);return{tree:await f(t,e,o,r,d),nodes:c.length,rows:c}}const i=await S(t,new Set,!1,o);let a={};try{a=await t.ticketCountsForNodes(o.map(r=>r.node_id))}catch{}return await g(t,i,a),{tree:await p(t,o,a),nodes:o.length,rows:i}},"run")});export{C as dashboardLeaf};

package/dist/commands/human/components.js

@@ -1,77 +1,3 @@
-import { defineBranch, defineLeaf } from '../../core/command.js';
-import { stateBlock } from '../../core/help.js';
-import { InputError } from '../../core/io.js';
-import { resolvePageComponents } from '../../core/config.js';
-import { componentNames, renderComponentCatalog, renderComponentContract } from '../../core/human/component-docs.js';
-function productComponents() {
-    return resolvePageComponents();
-}
-function componentNameState() {
-    const names = componentNames(productComponents());
-    return stateBlock('components', { count: names.length }, names.join(', '));
-}
-const humanComponentsList = defineLeaf({
-    name: 'list',
-    description: 'list page components for selection',
-    whenToUse: 'choosing which components to put in an authored page module.',
-    help: {
-        name: 'human components list',
-        summary: 'list page components for selection',
-        inputNote: 'No input parameters.',
-        output: [
-            { name: 'catalog', type: 'markdown', required: true, constraint: 'One concise selection entry per registry and product-registered component, grouped structural/response/display; no props or response schemas. A product component is written with the PascalCase tag derived from its registered kind.' },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'Points to `crtr human components show <component>` for one selected component contract.' },
-        ],
-        outputKind: 'object',
-        effects: ['None. Read-only.'],
-    },
-    run: async () => ({
-        catalog: renderComponentCatalog(productComponents()),
-        follow_up: 'Use `crtr human components show <component>` for one component contract.',
-    }),
-    render: (result) => `${String(result['catalog'])}\n\n${String(result['follow_up'])}`,
-});
-const humanComponentsShow = defineLeaf({
-    name: 'show',
-    description: 'show one page component contract',
-    whenToUse: 'authoring one selected page component and needing its exact props, response contract, and shape in a page module.',
-    help: {
-        name: 'human components show',
-        summary: 'show one page component contract',
-        params: [
-            { kind: 'positional', name: 'component', type: 'string', required: true, constraint: 'Component name from the live <components> catalog below. Case-sensitive: registry components are PascalCase.' },
-        ],
-        output: [
-            { name: 'component', type: 'string', required: true, constraint: 'The selected component name.' },
-            { name: 'contract', type: 'markdown', required: true, constraint: 'Hand-written props, response contract, and authoring example for that component. A shadcn family (Card, CardHeader, …) shares one contract covering every member.' },
-        ],
-        outputKind: 'object',
-        effects: ['None. Read-only.'],
-        dynamicState: componentNameState,
-    },
-    run: async (input) => {
-        const component = input['component'];
-        const contract = renderComponentContract(component, productComponents());
-        if (contract === undefined) {
-            throw new InputError({
-                error: 'unknown_component',
-                message: `unknown page component "${component}"`,
-                field: 'component',
-                next: 'Run `crtr human components show -h` and choose a component from its live catalog.',
-            });
-        }
-        return { component, contract };
-    },
-    render: (result) => String(result['contract']),
-});
-export const humanComponents = defineBranch({
-    name: 'components',
-    description: 'discover page components and their contracts',
-    whenToUse: 'authoring a page module and choosing components, or needing one component’s exact props and response contract.',
-    help: {
-        name: 'human components',
-        summary: 'discover page components and their contracts',
-        model: 'These are the components already in scope in a page module — no import, ever. List is the selection catalog; show owns the full props, response contract, and authoring shape for one selected component.',
-    },
-    children: [humanComponentsList, humanComponentsShow],
-});
+var s=Object.defineProperty;var e=(n,o)=>s(n,"name",{value:o,configurable:!0});import{defineBranch as c,defineLeaf as a}from"../../core/command.js";import{stateBlock as p}from"../../core/help.js";import{InputError as m}from"../../core/io.js";import{resolvePageComponents as i}from"../../core/config.js";import{componentNames as d,renderComponentCatalog as u,renderComponentContract as h}from"../../core/human/component-docs.js";function t(){return i()}e(t,"productComponents");function l(){const n=d(t());return p("components",{count:n.length},n.join(", "))}e(l,"componentNameState");const g=a({name:"list",description:"list page components for selection",whenToUse:"choosing which components to put in an authored page module.",help:{name:"human components list",summary:"list page components for selection",inputNote:"No input parameters.",output:[{name:"catalog",type:"markdown",required:!0,constraint:"One concise selection entry per registry and product-registered component, grouped structural/response/display; no props or response schemas. A product component is written with the PascalCase tag derived from its registered kind."},{name:"follow_up",type:"string",required:!0,constraint:"Points to `crtr human components show <component>` for one selected component contract."}],outputKind:"object",effects:["None. Read-only."]},run:e(async()=>({catalog:u(t()),follow_up:"Use `crtr human components show <component>` for one component contract."}),"run"),render:e(n=>`${String(n.catalog)}
+
+${String(n.follow_up)}`,"render")}),f=a({name:"show",description:"show one page component contract",whenToUse:"authoring one selected page component and needing its exact props, response contract, and shape in a page module.",help:{name:"human components show",summary:"show one page component contract",params:[{kind:"positional",name:"component",type:"string",required:!0,constraint:"Component name from the live <components> catalog below. Case-sensitive: registry components are PascalCase."}],output:[{name:"component",type:"string",required:!0,constraint:"The selected component name."},{name:"contract",type:"markdown",required:!0,constraint:"Hand-written props, response contract, and authoring example for that component. A shadcn family (Card, CardHeader, \u2026) shares one contract covering every member."}],outputKind:"object",effects:["None. Read-only."],dynamicState:l},run:e(async n=>{const o=n.component,r=h(o,t());if(r===void 0)throw new m({error:"unknown_component",message:`unknown page component "${o}"`,field:"component",next:"Run `crtr human components show -h` and choose a component from its live catalog."});return{component:o,contract:r}},"run"),render:e(n=>String(n.contract),"render")}),S=c({name:"components",description:"discover page components and their contracts",whenToUse:"authoring a page module and choosing components, or needing one component\u2019s exact props and response contract.",help:{name:"human components",summary:"discover page components and their contracts",model:"These are the components already in scope in a page module \u2014 no import, ever. List is the selection catalog; show owns the full props, response contract, and authoring shape for one selected component."},children:[g,f]});export{S as humanComponents};

package/dist/commands/human/feedback.js

@@ -1,112 +1 @@
-// `crtr human feedback` — the feedback companion's surface for a page ticket's
-// feedback comments. list shows every item with its id and status; resolve is
-// the companion's terminal report that an open item has been dealt with.
-// Creating comments is the person's channel (the page surface); no agent
-// authors, edits, or deletes them.
-import { envNodeId } from '../../shared/env.js';
-import { ApiError } from '../../api/index.js';
-import { defineBranch, defineLeaf } from '../../core/command.js';
-import { InputError } from '../../core/io.js';
-import { cliClient, rethrowAsCliError } from '../api-client.js';
-/** Feedback tickets are addressed by request identity; crtrd returns their inbox identity. */
-async function requirePageTicketId(raw) {
-    const requestId = raw;
-    try {
-        const request = await cliClient().getHumanRequest(requestId);
-        if (request.kind !== 'page')
-            throw new InputError({ error: 'not_found', message: `no page ticket: ${requestId}`, field: 'ticket_id', next: 'Pass the ticket id from your bearings, or a page ticket_id from `crtr human list`.' });
-        return { requestId, inboxTicketId: request.inbox_ticket_id };
-    }
-    catch (error) {
-        if (error instanceof InputError)
-            throw error;
-        rethrowAsCliError(error, 'Pass the ticket id from your bearings, or a page ticket_id from `crtr human list`.');
-    }
-}
-const humanFeedbackList = defineLeaf({
-    name: 'list',
-    description: "list a page ticket's feedback comments",
-    whenToUse: 'you are the feedback companion for a page ticket and need each comment\'s id and open/resolved status.',
-    help: {
-        name: 'human feedback list',
-        summary: "every feedback comment on one page ticket, with ids and open/resolved status",
-        params: [
-            { kind: 'positional', name: 'ticket_id', type: 'string', required: true, constraint: 'The page ticket id from your bearings (also the page_id from human send).' },
-        ],
-        output: [
-            { name: 'ticket_id', type: 'string', required: true, constraint: 'The page ticket id.' },
-            { name: 'open_count', type: 'integer', required: true, constraint: 'How many comments remain open. Zero once feedback exists means all of it has been dealt with.' },
-            { name: 'comments', type: 'object[]', required: true, constraint: 'Each: {id, quote, context?, note, status, created_at, resolved_at?}; status is open or resolved. Oldest first.' },
-        ],
-        outputKind: 'object',
-        effects: ['None. Read-only.'],
-    },
-    run: async (input) => {
-        const ticket = await requirePageTicketId(input['ticket_id']);
-        try {
-            const page = await cliClient().getHumanInboxPage(ticket.inboxTicketId);
-            return { ticket_id: ticket.requestId, open_count: page.feedback.open_count, comments: page.feedback.comments };
-        }
-        catch (e) {
-            rethrowAsCliError(e);
-        }
-    },
-});
-const humanFeedbackResolve = defineLeaf({
-    name: 'resolve',
-    description: 'mark one dealt-with feedback comment resolved',
-    whenToUse: 'you are the feedback companion and have dealt with an open comment — by revising the page or answering it in conversation.',
-    help: {
-        name: 'human feedback resolve',
-        summary: 'mark one open feedback comment resolved — terminal, and only after the feedback has actually been dealt with',
-        guide: 'Resolution is your report that the work is done, not a triage state: revise the page or answer the comment in conversation first, then resolve. It appends no chat turn — briefly report the result in the conversation yourself. A resolved comment never reopens; a renewed concern arrives as a new comment.',
-        params: [
-            { kind: 'positional', name: 'comment_id', type: 'string', required: true, constraint: 'A comment id from `crtr human feedback list`. The ticket is your own: it comes from the companion binding of the calling node.' },
-        ],
-        output: [
-            { name: 'resolved', type: 'boolean', required: true, constraint: 'True when this call resolved the comment; false when it was already resolved.' },
-            { name: 'ticket_id', type: 'string', required: true, constraint: 'The page ticket id.' },
-            { name: 'comment_id', type: 'string', required: true, constraint: 'The comment id.' },
-            { name: 'open_count', type: 'integer', required: false, constraint: 'Comments still open after this resolution. Present when resolved is true.' },
-            { name: 'reason', type: 'string', required: false, constraint: 'comment_already_resolved when resolved is false.' },
-        ],
-        outputKind: 'object',
-        effects: ["Marks the comment resolved in your own ticket's feedback record — the ticket comes from the calling companion's binding. Only the ticket's bound companion may resolve — any other node refuses with not_companion. A terminal ticket refuses with ticket_terminal — settlement already closed this collaboration."],
-    },
-    run: async (input) => {
-        const commentId = input['comment_id'];
-        const callerNodeId = envNodeId();
-        if (callerNodeId === undefined || callerNodeId === '') {
-            throw new InputError({ error: 'no_node', message: 'resolve runs inside the ticket\u2019s feedback companion (CRTR_NODE_ID unset)', next: 'Run this from the companion conversation bound to the ticket.' });
-        }
-        const binding = (await cliClient().getNode(callerNodeId)).review_binding;
-        if (binding === undefined || binding === null || binding.kind !== 'page_feedback') {
-            throw new InputError({ error: 'not_companion', message: 'this node is not a page-feedback companion — only the ticket\u2019s bound companion resolves its comments', next: 'Resolve from the companion conversation bound to the ticket.' });
-        }
-        const ticket = await requirePageTicketId(binding.review_id);
-        try {
-            const result = await cliClient().resolvePageFeedbackComment(ticket.inboxTicketId, commentId, callerNodeId);
-            return { resolved: true, ticket_id: ticket.requestId, comment_id: commentId, open_count: result.feedback.open_count };
-        }
-        catch (e) {
-            if (e instanceof ApiError && e.status === 409 && e.code === 'comment_already_resolved') {
-                return { resolved: false, ticket_id: ticket.requestId, comment_id: commentId, reason: 'comment_already_resolved' };
-            }
-            rethrowAsCliError(e);
-        }
-    },
-    render: (r) => r['resolved'] === true
-        ? `Resolved feedback comment ${r['comment_id']} — ${r['open_count']} still open on ${r['ticket_id']}.`
-        : `Nothing to resolve for ${r['comment_id']} — ${r['reason']}.`,
-});
-export const humanFeedbackBranch = defineBranch({
-    name: 'feedback',
-    description: "operate on a page ticket's feedback comments",
-    whenToUse: "you are a feedback companion working a page ticket's feedback comments.",
-    help: {
-        name: 'human feedback',
-        summary: "a page ticket's feedback comments — the person creates them on the page; the bound companion lists and resolves them",
-        model: 'Each comment is immutable once sent and open until resolved. resolve is terminal and companion-only, taken after the feedback has been dealt with by revising the page or answering in conversation.',
-    },
-    children: [humanFeedbackList, humanFeedbackResolve],
-});
+var u=Object.defineProperty;var a=(t,n)=>u(t,"name",{value:n,configurable:!0});import{envNodeId as h}from"../../shared/env.js";import{ApiError as p}from"../../api/index.js";import{defineBranch as k,defineLeaf as m}from"../../core/command.js";import{InputError as r}from"../../core/io.js";import{cliClient as s,rethrowAsCliError as d}from"../api-client.js";async function l(t){const n=t;try{const e=await s().getHumanRequest(n);if(e.kind!=="page")throw new r({error:"not_found",message:`no page ticket: ${n}`,field:"ticket_id",next:"Pass the ticket id from your bearings, or a page ticket_id from `crtr human list`."});return{requestId:n,inboxTicketId:e.inbox_ticket_id}}catch(e){if(e instanceof r)throw e;d(e,"Pass the ticket id from your bearings, or a page ticket_id from `crtr human list`.")}}a(l,"requirePageTicketId");const f=m({name:"list",description:"list a page ticket's feedback comments",whenToUse:"you are the feedback companion for a page ticket and need each comment's id and open/resolved status.",help:{name:"human feedback list",summary:"every feedback comment on one page ticket, with ids and open/resolved status",params:[{kind:"positional",name:"ticket_id",type:"string",required:!0,constraint:"The page ticket id from your bearings (also the page_id from human send)."}],output:[{name:"ticket_id",type:"string",required:!0,constraint:"The page ticket id."},{name:"open_count",type:"integer",required:!0,constraint:"How many comments remain open. Zero once feedback exists means all of it has been dealt with."},{name:"comments",type:"object[]",required:!0,constraint:"Each: {id, quote, context?, note, status, created_at, resolved_at?}; status is open or resolved. Oldest first."}],outputKind:"object",effects:["None. Read-only."]},run:a(async t=>{const n=await l(t.ticket_id);try{const e=await s().getHumanInboxPage(n.inboxTicketId);return{ticket_id:n.requestId,open_count:e.feedback.open_count,comments:e.feedback.comments}}catch(e){d(e)}},"run")}),b=m({name:"resolve",description:"mark one dealt-with feedback comment resolved",whenToUse:"you are the feedback companion and have dealt with an open comment \u2014 by revising the page or answering it in conversation.",help:{name:"human feedback resolve",summary:"mark one open feedback comment resolved \u2014 terminal, and only after the feedback has actually been dealt with",guide:"Resolution is your report that the work is done, not a triage state: revise the page or answer the comment in conversation first, then resolve. It appends no chat turn \u2014 briefly report the result in the conversation yourself. A resolved comment never reopens; a renewed concern arrives as a new comment.",params:[{kind:"positional",name:"comment_id",type:"string",required:!0,constraint:"A comment id from `crtr human feedback list`. The ticket is your own: it comes from the companion binding of the calling node."}],output:[{name:"resolved",type:"boolean",required:!0,constraint:"True when this call resolved the comment; false when it was already resolved."},{name:"ticket_id",type:"string",required:!0,constraint:"The page ticket id."},{name:"comment_id",type:"string",required:!0,constraint:"The comment id."},{name:"open_count",type:"integer",required:!1,constraint:"Comments still open after this resolution. Present when resolved is true."},{name:"reason",type:"string",required:!1,constraint:"comment_already_resolved when resolved is false."}],outputKind:"object",effects:["Marks the comment resolved in your own ticket's feedback record \u2014 the ticket comes from the calling companion's binding. Only the ticket's bound companion may resolve \u2014 any other node refuses with not_companion. A terminal ticket refuses with ticket_terminal \u2014 settlement already closed this collaboration."]},run:a(async t=>{const n=t.comment_id,e=h();if(e===void 0||e==="")throw new r({error:"no_node",message:"resolve runs inside the ticket\u2019s feedback companion (CRTR_NODE_ID unset)",next:"Run this from the companion conversation bound to the ticket."});const i=(await s().getNode(e)).review_binding;if(i==null||i.kind!=="page_feedback")throw new r({error:"not_companion",message:"this node is not a page-feedback companion \u2014 only the ticket\u2019s bound companion resolves its comments",next:"Resolve from the companion conversation bound to the ticket."});const c=await l(i.review_id);try{const o=await s().resolvePageFeedbackComment(c.inboxTicketId,n,e);return{resolved:!0,ticket_id:c.requestId,comment_id:n,open_count:o.feedback.open_count}}catch(o){if(o instanceof p&&o.status===409&&o.code==="comment_already_resolved")return{resolved:!1,ticket_id:c.requestId,comment_id:n,reason:"comment_already_resolved"};d(o)}},"run"),render:a(t=>t.resolved===!0?`Resolved feedback comment ${t.comment_id} \u2014 ${t.open_count} still open on ${t.ticket_id}.`:`Nothing to resolve for ${t.comment_id} \u2014 ${t.reason}.`,"render")}),I=k({name:"feedback",description:"operate on a page ticket's feedback comments",whenToUse:"you are a feedback companion working a page ticket's feedback comments.",help:{name:"human feedback",summary:"a page ticket's feedback comments \u2014 the person creates them on the page; the bound companion lists and resolves them",model:"Each comment is immutable once sent and open until resolved. resolve is terminal and companion-only, taken after the feedback has been dealt with by revising the page or answering in conversation."},children:[f,b]});export{I as humanFeedbackBranch};