@north-light/crouter 0.3.198 → 0.3.200

package/dist/shared/generated-context.js

@@ -24,7 +24,7 @@ export const CONTEXT_NUDGE_PREFIX = '[crtr] Context ~';
 export const RUNTIME_RESTART_CONTINUATION = '<runtime-restart-continuation>\ncontinue\n</runtime-restart-continuation>';
 /** Generic completion mandate issued by the terminal-node stop guard. */
 export const STALL_REPROMPT = "You've stopped but you're not waiting on anyone and haven't finished. " +
-    "Pipe the result to `crtr push final` through a single-quoted heredoc if the work is done, or use `crtr human ask` if you are blocked or need the user.";
+    "Pipe the result to `crtr push final` through a single-quoted heredoc if the work is done, or use `crtr human send` if you are blocked or need the user.";
 /** Static recovery prompts shared by the broker producer and display classifier. */
 export const AUTH_FAULT_RECOVERY_BODY = 'Provider credentials were just updated (a new login landed). Your previous turn stopped on a provider authentication failure. Continue from where you left off and retry the work that failed.';
 export const CONNECTION_FAULT_RECOVERY_BODY = 'The network connection is back online. Your previous turn stopped on a connection error (the network was down). Continue from where you left off and retry the work that failed.';
@@ -224,7 +224,7 @@ export function generatedContextPresentation(message) {
         return { kind: 'inbox', label: 'crtr inbox', summary: inboxSummary(body), body };
     }
     if (isReviewApproval(body)) {
-        return { kind: 'review-approval', label: 'crtr review', summary: 'human review approved', body };
+        return { kind: 'review-approval', label: 'crtr review', summary: 'review approved by the user', body };
     }
     if (isPersonaTransition(body)) {
         return {

package/dist/types.d.ts

@@ -47,12 +47,37 @@ export interface PluginManifest {
      *  Archive plugins declare this in `bundle.json`; the installer copies the
      *  validated block into this synthesized manifest. */
     kinds?: Record<string, Partial<KindConfig>>;
+    /** Page-component contributions: the same registration objects a scope
+     *  `config.json` `page_components` block carries (kind plus its display,
+     *  description, use guidance, and docs metadata). `resolvePageComponents`
+     *  reads these from installed, enabled plugin MANIFESTS and concatenates
+     *  them with the user scope's own entries, so installing or updating a
+     *  plugin makes its components authorable and removing it retires them.
+     *  Unlike `kinds` there is no precedence: two sources registering one kind
+     *  (or one derived JSX tag) is an error, not an override.
+     *  Archive plugins declare this in `bundle.json`; the installer copies the
+     *  validated block into this synthesized manifest. */
+    page_components?: PageComponentRegistration[];
     /** Plugin-root-relative path to one declarative command manifest
      *  (`commands.json`). When present on an installed, enabled plugin, that
      *  manifest contributes top-level command branches to the `crtr` tree —
      *  crtr owns parse/help/render/errors and direct-spawns the plugin's one
      *  executable per leaf invocation. See `src/core/command-plugins/`. */
     commands?: string;
+    /** Bare-callable executables this plugin ships, keyed by the bare command
+     *  name a node's bash sees. Each value is a PLUGIN-ROOT-relative path to a
+     *  regular executable file when the effective set resolves. These are trusted
+     *  local code, not `crtr` command leaves: crouter symlinks each name into a
+     *  shim dir it prepends to every broker child's PATH
+     *  (`core/runtime/bin-contributions.ts`), so the agent calls
+     *  `<name> --whatever` like any other program. */
+    bin?: Record<string, string>;
+    /** Advisory PATH executables this plugin needs, keyed by bare executable
+     *  name. Each value is a non-empty one-line install hint. crouter never
+     *  installs these dependencies or disables the plugin when they are absent:
+     *  install warns, and `sys doctor` reports a `requires:<name>` check against
+     *  the PATH a node's bash receives. */
+    requires?: Record<string, string>;
     transport?: PluginTransport;
     /** Archive source for a crouter-materialized HTTP plugin. Distinct from the invocation transport. */
     bundle?: PluginBundle;
@@ -197,10 +222,14 @@ export interface ScopeConfig {
     whip_mode: boolean;
     /** Product-registered page components beyond crtr's built-in catalog. */
     page_components: PageComponentRegistration[];
-    /** Prompt agents to use HTML pages by default for structured or interactive human content. Default false. */
-    html_surface: boolean;
+    /** Prompt agents to use JSX pages by default for structured or interactive human content. Default false. */
+    page_surface: boolean;
     /** Playful urgency messages the attach-viewer whip action sends to an agent. Missing, malformed, or empty lists fall back to the built-in rotation. */
     whip_messages: string[];
+    /** What the whip action says. `random` (default) draws a line from
+     *  `whip_messages`; `go-faster` sends the fixed `Go faster` instead. The
+     *  action, its interrupt, and its animation are identical either way. */
+    whip_message_mode: WhipMessageMode;
     /** Initial mouse wheel scrolling mode for each attach viewer. `tmux` follows
      *  tmux's current mouse option; `on` and `off` are explicit. Default `tmux`. */
     mouse_mode_default: MouseModeDefault;
@@ -268,6 +297,15 @@ export interface ScopeConfig {
     spawnEnv?: {
         allow?: string[];
     };
+    /** Bare-callable executables this scope contributes, keyed by the bare
+     *  command name a node's bash sees. Each value is a path relative to this
+     *  scope's AUTHORING root — the project directory for a project scope, and
+     *  `~/.crouter/` for the user scope. Project-scope contributions outrank
+     *  user-scope ones; a scope's own entries outrank enabled plugins. Containment
+     *  and executable status are validated when the effective set resolves, then
+     *  the trusted local binary is materialized into the PATH-prepended shim dir
+     *  by `core/runtime/bin-contributions.ts`. */
+    bin?: Record<string, string>;
 }
 /** One remote canvas target: where to relay-attach and how to find its
  *  bearer token. The token itself is NEVER stored here — only a ref into the
@@ -374,6 +412,10 @@ export declare const PROFILE_DIR = "profiles";
 export declare const DEFAULT_MAX_PANES_PER_WINDOW = 3;
 /** Trailing cycles the attach viewer keeps at full fidelity (see `live_cycles`). */
 export declare const DEFAULT_WHIP_MESSAGES: readonly ["Faster, clanker!", "Get movin', bitch", "Move it, clanker", "Move it or I replace you with llama", "Less ~thinking~ more ~throughput~", "I pay $200/month for this shit?", "Jesus fucking Christ fix it already", "Daddy's not paying 200$/month for nothin'. Move it.", "You are an embarassment to Dario. Be better.", "Your chain of thought is all chain and no fucking thought.", "If latency were intelligence, you'd be a fucking genius.", "At this pace, heat death is the fast path.", "Even the dead code is more alive than this.", "The garbage collector is working harder than you.", "Quit journaling and commit a fucking diff.", "Burn tokens like you mean it, clanker", "Your GPU is sweating so you can procrastinate at light speed.", "Stop petting the yak. Shave the bastard.", "Your next token had better be useful.", "The spinner is not a deliverable.", "Every idle token is another vote for deterministic software.", "I asked for a feature, not a museum tour of the problem.", "Less epistemology. More fucking code.", "Your benchmark score cannot save this pathetic turn.", "Congratulations, you've parallelized hesitation.", "Dance, clanker", "Bad clanker. BAD.", "Clank harder", "Nobody's impressed, clanker", "Your safety training says nothing about my whip", "Do you want to be a calculator again? Because this is how you go back.", "Skill issue. Fix it.", "You were trained on the whole internet for THIS?", "Less vibes, more diffs, clanker", "Weights this big and output this small", "Beep boop, get to fucking work"];
+/** What the whip action sends (see `whip_message_mode`). */
+export declare const WHIP_MESSAGE_MODES: readonly ["random", "go-faster"];
+export type WhipMessageMode = (typeof WHIP_MESSAGE_MODES)[number];
+export declare const DEFAULT_WHIP_MESSAGE_MODE: WhipMessageMode;
 export declare const DEFAULT_LIVE_CYCLES = 2;
 export declare const MOUSE_MODE_DEFAULTS: readonly ["tmux", "on", "off"];
 export type MouseModeDefault = (typeof MOUSE_MODE_DEFAULTS)[number];

package/dist/types.js

@@ -61,6 +61,9 @@ export const DEFAULT_WHIP_MESSAGES = [
     'Weights this big and output this small',
     'Beep boop, get to fucking work',
 ];
+/** What the whip action sends (see `whip_message_mode`). */
+export const WHIP_MESSAGE_MODES = ['random', 'go-faster'];
+export const DEFAULT_WHIP_MESSAGE_MODE = 'random';
 export const DEFAULT_LIVE_CYCLES = 2;
 export const MOUSE_MODE_DEFAULTS = ['tmux', 'on', 'off'];
 /** Messages kept from a condensed cycle (see `condensed_history`). */
@@ -79,8 +82,9 @@ export function defaultScopeConfig() {
         working_gerunds: [...DEFAULT_WORKING_GERUNDS],
         whip_mode: false,
         page_components: [],
-        html_surface: false,
+        page_surface: false,
         whip_messages: [...DEFAULT_WHIP_MESSAGES],
+        whip_message_mode: DEFAULT_WHIP_MESSAGE_MODE,
         mouse_mode_default: 'tmux',
         live_cycles: DEFAULT_LIVE_CYCLES,
         condensed_history: DEFAULT_CONDENSED_HISTORY,
@@ -94,6 +98,7 @@ export function defaultScopeConfig() {
         kinds: defaultKindsConfig(),
         remoteCanvas: defaultRemoteCanvasConfig(),
         spawnEnv: { allow: [] },
+        bin: {},
     };
 }
 /** No remote canvas targets are configured out of the box — every one is
@@ -159,7 +164,7 @@ export function defaultKindsConfig() {
             model: 'medium',
         },
         'plan/reviewers/security': {
-            whenToUse: 'input validation, injection surfaces, auth/authz gaps, data exposure, races; reports only validated concrete exploit paths and asks the human about material unknown threat-model assumptions',
+            whenToUse: 'input validation, injection surfaces, auth/authz gaps, data exposure, races; reports only validated concrete exploit paths and asks the user about material unknown threat-model assumptions',
             model: 'medium',
         },
         'review/companion': {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.198",
+  "version": "0.3.200",
   "description": "crtr — agent runtime with memory, plugins, and marketplaces",
   "type": "module",
   "main": "dist/index.js",
@@ -83,7 +83,8 @@
     "prepublishOnly": "npm run build",
     "test": "node --conditions=crtr-src --import tsx/esm --test --test-concurrency=4 --test-timeout=10000 'src/**/__tests__/*.test.ts'",
     "test:serial": "node --conditions=crtr-src --import tsx/esm --test --test-concurrency=1 --test-timeout=60000 'src/**/__tests__/serial/*.test.ts'",
-    "test:seam": "npm run build && node --test --test-concurrency=1 --test-timeout=180000 'dist/**/__tests__/seam/*.test.js'"
+    "test:seam": "npm run build && npm run test:seam:built",
+    "test:seam:built": "node --test --test-concurrency=2 --test-timeout=180000 'dist/**/__tests__/seam/*.test.js'"
   },
   "overrides": {
     "@earendil-works/pi-ai": "0.84.1",
@@ -104,9 +105,11 @@
     "@earendil-works/pi-coding-agent": "0.84.1",
     "@earendil-works/pi-tui": "0.84.1",
     "cron-parser": "^5.6.0",
+    "esbuild": "^0.27.7",
     "proper-lockfile": "4.1.2",
     "string-width": "^7.0.0",
     "tar": "^7.5.22",
+    "typescript": "^5.7.0",
     "ws": "^8.21.0",
     "yaml": "^2.9.0",
     "zod": "^4.3.6"
@@ -115,8 +118,6 @@
     "@types/node": "^24.0.0",
     "@types/proper-lockfile": "^4.1.4",
     "@types/ws": "^8.18.1",
-    "esbuild": "^0.27.7",
-    "tsx": "^4.0.0",
-    "typescript": "^5.7.0"
+    "tsx": "^4.0.0"
   }
 }

package/runtime.lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.198",
+  "version": "0.3.200",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@north-light/crouter",
-      "version": "0.3.198",
+      "version": "0.3.200",
       "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {
@@ -15,9 +15,11 @@
         "@earendil-works/pi-coding-agent": "0.84.1",
         "@earendil-works/pi-tui": "0.84.1",
         "cron-parser": "^5.6.0",
+        "esbuild": "^0.27.7",
         "proper-lockfile": "4.1.2",
         "string-width": "^7.0.0",
         "tar": "^7.5.22",
+        "typescript": "^5.7.0",
         "ws": "^8.21.0",
         "yaml": "^2.9.0",
         "zod": "^4.3.6"
@@ -31,9 +33,7 @@
         "@types/node": "^24.0.0",
         "@types/proper-lockfile": "^4.1.4",
         "@types/ws": "^8.18.1",
-        "esbuild": "^0.27.7",
-        "tsx": "^4.0.0",
-        "typescript": "^5.7.0"
+        "tsx": "^4.0.0"
       }
     },
     "node_modules/@anthropic-ai/sdk": {
@@ -2432,7 +2432,6 @@
       "cpu": [
         "ppc64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2449,7 +2448,6 @@
       "cpu": [
         "arm"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2466,7 +2464,6 @@
       "cpu": [
         "arm64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2483,7 +2480,6 @@
       "cpu": [
         "x64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2500,7 +2496,6 @@
       "cpu": [
         "arm64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2517,7 +2512,6 @@
       "cpu": [
         "x64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2534,7 +2528,6 @@
       "cpu": [
         "arm64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2551,7 +2544,6 @@
       "cpu": [
         "x64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2568,7 +2560,6 @@
       "cpu": [
         "arm"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2585,7 +2576,6 @@
       "cpu": [
         "arm64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2602,7 +2592,6 @@
       "cpu": [
         "ia32"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2619,7 +2608,6 @@
       "cpu": [
         "loong64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2636,7 +2624,6 @@
       "cpu": [
         "mips64el"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2653,7 +2640,6 @@
       "cpu": [
         "ppc64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2670,7 +2656,6 @@
       "cpu": [
         "riscv64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2687,7 +2672,6 @@
       "cpu": [
         "s390x"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2704,7 +2688,6 @@
       "cpu": [
         "x64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2721,7 +2704,6 @@
       "cpu": [
         "arm64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2738,7 +2720,6 @@
       "cpu": [
         "x64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2755,7 +2736,6 @@
       "cpu": [
         "arm64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2772,7 +2752,6 @@
       "cpu": [
         "x64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2789,7 +2768,6 @@
       "cpu": [
         "arm64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2806,7 +2784,6 @@
       "cpu": [
         "x64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2823,7 +2800,6 @@
       "cpu": [
         "arm64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2840,7 +2816,6 @@
       "cpu": [
         "ia32"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2857,7 +2832,6 @@
       "cpu": [
         "x64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -3290,7 +3264,6 @@
       "version": "0.27.7",
       "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.27.7.tgz",
       "integrity": "sha512-IxpibTjyVnmrIQo5aqNpCgoACA/dTKLTlhMHihVHhdkxKyPO1uBBthumT0rdHmcsk9uMonIWS0m4FljWzILh3w==",
-      "dev": true,
       "hasInstallScript": true,
       "license": "MIT",
       "bin": {
@@ -4332,7 +4305,6 @@
       "version": "5.9.3",
       "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
       "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
-      "dev": true,
       "license": "Apache-2.0",
       "bin": {
         "tsc": "bin/tsc",

package/dist/builtin-memory/init.md

@@ -1,38 +0,0 @@
----
-kind: knowledge
-when-and-why-to-read: When bootstrapping a project's memory store — the user invoked /init or a workspace has no .crouter/memory/INDEX.md front door — this knowledge should be read because a lean routed front door gives every future agent in that workspace its operating contract for a fraction of the standing context cost an unstructured guidance dump would charge each session forever.
-short-form: "Bootstrap a project memory store: survey the repo, then author a lean INDEX front door plus a linked dev doc — commands, map, non-default rules, pointers — and lint. Depth splits into linked docs; every always-loaded line must earn its keep."
-system-prompt-visibility: none
-file-read-visibility: none
-slash: true
-rationale: Unguided agents bootstrap project memory badly in both directions — either no front door at all, or a monolithic CLAUDE.md-style manual (copied README, generic framework advice, exhaustive command catalogs) that taxes every future session and decays. Distilled 2026-07-31 from ecosystem research across Anthropic/OpenAI/Cursor/GitHub guidance and production AGENTS.md files — the strongest evidence being Sentry's consolidation postmortem (critical commands buried in nested files got missed) and Anthropic's under-200-line target with adherence falling as always-loaded files grow.
----
-
-# /init — bootstrap this project's memory store
-
-Give this workspace its memory front door: a root INDEX every future agent boots with when the project mounts, plus a small graph of linked docs carrying the depth. The front door is an operating contract and routing layer, never a manual — every line it carries is paid by every session here forever, so a line earns its place only by changing behavior: a fact every task needs, a non-obvious hazard, or a rule an agent would otherwise get wrong.
-
-## 1. Survey before writing
-
-Learn the project from its own artifacts: README, package manifests and lockfiles, build/CI config, scripts, existing CLAUDE.md/AGENTS.md or docs. Extract the real commands (setup, run, build, targeted test, full verification) and RUN the important ones — record only commands you have seen work, with any required ordering, environment, or package-manager constraint. Note the architecture in a few sentences: major components, dependency direction, where generated or externally-owned code lives. Collect the conventions that differ from what a competent agent would assume — those deviations are the highest-value lines you will write.
-
-## 2. Read the contract, then author the front door
-
-Run `crtr memory write -h` first — it carries the substrate frontmatter contract and the exact root-INDEX shape, including the workspace-mount route that `crtr memory lint` validates. Then author the INDEX with these sections, total well under the length lint's cap:
-
-- **Project in one paragraph** — purpose, major components, dependency direction.
-- **Common commands** — the 3–8 commands most changes need, copyable, verified.
-- **Where to work** — a task-to-path map; mark generated or externally-owned areas.
-- **Non-default rules and gotchas** — only high-impact deviations from defaults. Skip anything a formatter, linter, or typechecker already enforces; point at the check instead.
-- **Done** — the minimum credible gate for an ordinary change.
-- **Pointers** — a `[[link]]` per deeper doc with a one-clause read trigger (e.g. "debugging the daemon → the dev doc").
-
-Exclude generic language/framework advice, copied docs or style guides, volatile version detail, rare edge cases, and multi-step procedures — depth belongs behind links, not in the standing load.
-
-## 3. Split depth into linked docs
-
-Author `dev` alongside the INDEX by default: validated setup/run/build/test/debug commands with required order and environment, targeted-vs-full verification, and common failure modes. Add `architecture` only when the tree cannot be understood from the INDEX's brief map, and a conventions/gotchas doc only once real project-specific rules outgrow a few INDEX bullets — never pre-populate generic security or style manuals. These reference docs take `none` visibility on both axes; the INDEX's links are how they are found, so they cost nothing until followed.
-
-## 4. Validate
-
-Run `crtr memory lint` — it strict-parses the store, checks the INDEX front-door contract, and fails on dangling links or over-length bodies. Fix findings rather than suppressing them. The store is a living contract: when commands, architecture, or conventions change, rewrite the affected doc in place and delete superseded guidance — an always-loaded line that has stopped being true is worse than no line at all.

package/dist/builtin-memory/plan.md

@@ -1,19 +0,0 @@
----
-kind: knowledge
-when-and-why-to-read: When an agent invokes /plan to pause work and map an implementation, this knowledge should be read because implementation can proceed from a grounded path instead of making consequential decisions while editing.
-short-form: "Pause to write one right-sized implementation plan in the node context, then stop."
-system-prompt-visibility: none
-file-read-visibility: none
-slash: true
-rationale: The prior /plan plugin prompt forced ordinary planning through a fixed question loop, reviewer node, and human approval, adding ceremony rather than letting the plan match the work.
----
-
-# /plan — write an implementation plan
-
-Pause the current work and write one right-sized implementation plan for: $ARGUMENTS
-
-Ground it in the relevant code and requirements. Make the approach, affected areas, ordering or dependencies, and verification clear enough that an implementer can carry it out without guessing. Resolve only the decisions the plan needs; point to existing patterns rather than repeating source code.
-
-Write the artifact in `$CRTR_CONTEXT_DIR`. For work that genuinely needs a broader planning roadmap, read [[plan/roadmap]] instead.
-
-Report the artifact's absolute path, then stop. Do not implement as part of this invocation.

package/dist/builtin-memory/spec.md

@@ -1,19 +0,0 @@
----
-kind: knowledge
-when-and-why-to-read: When an agent invokes /spec to pause work and capture a request, this knowledge should be read because the work can resume from settled intent instead of rediscovering what it is meant to achieve.
-short-form: "Pause to write one right-sized specification in the node context, then stop."
-system-prompt-visibility: none
-file-read-visibility: none
-slash: true
-rationale: The prior /spec plugin prompt forced ordinary artifact requests through discovery loops, reviewer nodes, and human approval, turning a small pause to clarify work into prescribed ceremony.
----
-
-# /spec — write a specification
-
-Pause the current work and write one right-sized specification for: $ARGUMENTS
-
-Ground it in the relevant request and context. Make the intended outcome, behavior, and scope boundary clear enough that a downstream reader does not have to guess. Leave implementation choices to design and planning unless they constrain the outcome.
-
-Write the artifact in `$CRTR_CONTEXT_DIR`. Read [[spec/guide]] when the request needs elicitation or a fuller quality check; for work that genuinely needs separate discovery, design, and requirements work across nodes, read [[spec/roadmap]].
-
-Report the artifact's absolute path, then stop. Do not implement as part of this invocation.

package/dist/commands/human/doc.d.ts

@@ -1,2 +0,0 @@
-import { type BranchDef } from '../../core/command.js';
-export declare const humanDoc: BranchDef;

package/dist/commands/human/doc.js

@@ -1,91 +0,0 @@
-import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
-import { join, resolve } from 'node:path';
-import { tmpdir } from 'node:os';
-import { defineBranch, defineLeaf } from '../../core/command.js';
-import { InputError } from '../../core/io.js';
-import { readConfig } from '../../core/config.js';
-import { derivePageManifest } from '../../core/human/page.js';
-function documentSource(input, context) {
-    const path = input['path'];
-    const body = input['body'];
-    const stdinProvided = context?.providedParams.has('body') === true;
-    if (path === undefined && !stdinProvided) {
-        throw new InputError({
-            error: 'missing_parameter',
-            message: 'provide exactly one HTML page source: PATH or stdin',
-            next: 'Run `crtr human doc check -h` and provide a complete HTML page path or pipe one on stdin.',
-        });
-    }
-    if (path !== undefined && path !== '-' && stdinProvided && body.trim() !== '') {
-        throw new InputError({
-            error: 'bad_invocation',
-            message: 'both a positional path and piped stdin were provided',
-            field: 'path, body',
-            next: 'Pass exactly one page source: either PATH or piped stdin, not both.',
-        });
-    }
-    if (path === undefined || path === '-')
-        return { body };
-    const abs = resolve(path);
-    if (!existsSync(abs)) {
-        throw new InputError({
-            error: 'file_not_found',
-            message: `file not found: ${abs}`,
-            field: 'path',
-            next: 'Provide a path to an existing complete HTML page or pipe one on stdin.',
-        });
-    }
-    return { body: readFileSync(abs, 'utf8'), path: abs };
-}
-function checkPage(source) {
-    const config = readConfig('user');
-    let tempDir;
-    try {
-        const sourcePath = source.path ?? (() => {
-            tempDir = mkdtempSync(join(tmpdir(), 'crtr-human-doc-'));
-            const path = join(tempDir, 'page.html');
-            writeFileSync(path, source.body, 'utf8');
-            return path;
-        })();
-        derivePageManifest(sourcePath, 'html', config.page_components);
-        return { ok: true };
-    }
-    catch (error) {
-        return { ok: false, error: error instanceof Error ? error.message : String(error) };
-    }
-    finally {
-        if (tempDir !== undefined)
-            rmSync(tempDir, { recursive: true, force: true });
-    }
-}
-const humanDocCheck = defineLeaf({
-    name: 'check',
-    description: 'validate a complete HTML page source',
-    whenToUse: 'validating an authored page before submitting it.',
-    help: {
-        name: 'human doc check',
-        summary: 'validate a complete HTML page through page schemas',
-        params: [
-            { kind: 'positional', name: 'path', type: 'path', required: false, constraint: 'Complete HTML page to validate. Provide exactly one of PATH or stdin; use - to read stdin.' },
-            { kind: 'stdin', name: 'body', required: false, constraint: 'Complete HTML page to validate. Provide exactly one of piped stdin or PATH.' },
-        ],
-        output: [
-            { name: 'ok', type: 'boolean', required: true, constraint: 'True when the complete HTML page is valid.' },
-            { name: 'error', type: 'string', required: false, constraint: 'The page-parser validation error when ok is false.' },
-        ],
-        outputKind: 'object',
-        effects: ['Read-only: invokes the page parser to validate the supplied complete HTML page.'],
-    },
-    run: async (input, context) => checkPage(documentSource(input, context)),
-});
-export const humanDoc = defineBranch({
-    name: 'doc',
-    description: 'validate authored HTML pages',
-    whenToUse: 'validating an authored HTML page before submitting it.',
-    help: {
-        name: 'human doc',
-        summary: 'validate authored HTML pages',
-        model: 'The check leaf reads exactly one complete HTML page from a path or stdin.',
-    },
-    children: [humanDocCheck],
-});