@crouton-kit/crouter 0.3.46 → 0.3.48

package/dist/core/runtime/bearings.js

@@ -13,10 +13,15 @@
 //     the source's whole conversation and then impersonates it. A non-fork
 //     node's bearings are its FIRST entry, so there is nothing earlier to
 //     disown; it gets only the declarative identity line. The message also
-//     carries the <project_context> block (buildProjectContextBlock) — the
-//     AGENTS.md/CLAUDE.md project instructions, moved OUT of the system prompt
-//     (pi's copy is suppressed via noContextFiles in broker.ts) so they ride
-//     this user message instead;
+//     carries the <project_context> block (buildProjectContextBlock) — now just
+//     the cwd/git <environment> snapshot. Project instructions (what used to be
+//     a re-rendered AGENTS.md/CLAUDE.md here) come from the document substrate
+//     instead: `crtr sys sync` migrates each CLAUDE.md/AGENTS.md into that
+//     dir's own `.crouter/memory/AGENTS.md` at content/content, so it rides the
+//     <memory kind="knowledge"> block below (renderKnowledgeBlock) via the
+//     profile-widened boot render, exactly like any other substrate doc — no
+//     parallel re-implementation of pi's project-context loader lives here
+//     anymore (see `crtr memory read taste/document-substrate`);
 //   • promote.ts folds orchestratorContextNote() into the promotion guidance
 //     dump, so a node that becomes an orchestrator MID-LIFE gets the
 //     orchestrator framing it never received at spawn — it spawned as a base
@@ -36,78 +41,10 @@
 // This across-cycles note is the ONE thing a terminal worker's bearings drop.
 import { contextDir, getNode, fullName, subscriptionsOf, } from '../canvas/index.js';
 import { execSync } from 'node:child_process';
-import { existsSync, readFileSync, readdirSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join, resolve } from 'node:path';
+import { readdirSync } from 'node:fs';
 import { cadenceDisplay } from '../wake.js';
 import { renderKnowledgeBlock } from '../substrate/index.js';
 import { loadProfileManifest } from '../profiles/manifest.js';
-// ---------------------------------------------------------------------------
-// Project context (<project_context>) — the AGENTS.md/CLAUDE.md files pi would
-// otherwise inject into its SYSTEM PROMPT, rendered here so they ride the
-// first-message bearings instead (pi's copy is suppressed via
-// resourceLoaderOptions.noContextFiles in broker.ts). We re-implement pi's
-// loadProjectContextFiles + getAgentDir (resource-loader.js / config.js) rather
-// than IMPORT pi: bearings.ts is statically imported by the thin daemon (crtrd,
-// for wakeOriginFrom), so a static @earendil-works import would pull the whole
-// pi engine into the supervisor. The discovery is a stable convention + pure fs.
-// ---------------------------------------------------------------------------
-/** pi's getAgentDir(): the global agent config dir holding a user-wide context
- *  file. Honors PI_CODING_AGENT_DIR (tilde-expanded), else ~/.pi/agent (pi's
- *  piConfig.configDir is ".pi"). */
-function piAgentDir() {
-    const env = process.env['PI_CODING_AGENT_DIR'];
-    if (env !== undefined && env !== '') {
-        return env.startsWith('~') ? join(homedir(), env.slice(1)) : env;
-    }
-    return join(homedir(), '.pi', 'agent');
-}
-/** Per-dir context-file candidates, in pi's precedence order (first match wins). */
-const CONTEXT_FILE_CANDIDATES = ['AGENTS.md', 'AGENTS.MD', 'CLAUDE.md', 'CLAUDE.MD'];
-function loadContextFileFromDir(dir) {
-    for (const name of CONTEXT_FILE_CANDIDATES) {
-        const p = join(dir, name);
-        if (existsSync(p)) {
-            try {
-                return { path: p, content: readFileSync(p, 'utf8') };
-            }
-            catch {
-                // Unreadable candidate — skip, mirroring pi (best-effort).
-            }
-        }
-    }
-    return null;
-}
-/** Mirror of pi's loadProjectContextFiles: the global agent-dir file first, then
- *  every AGENTS.md/CLAUDE.md up the cwd's ancestry, ordered root→cwd (so the
- *  most-specific project file reads last). Deduped by absolute path. */
-function loadProjectContextFiles(cwd) {
-    const files = [];
-    const seen = new Set();
-    const global = loadContextFileFromDir(piAgentDir());
-    if (global !== null) {
-        files.push(global);
-        seen.add(global.path);
-    }
-    const ancestors = [];
-    let dir = resolve(cwd);
-    const root = resolve('/');
-    for (;;) {
-        const f = loadContextFileFromDir(dir);
-        if (f !== null && !seen.has(f.path)) {
-            ancestors.unshift(f);
-            seen.add(f.path);
-        }
-        if (dir === root)
-            break;
-        const parent = resolve(dir, '..');
-        if (parent === dir)
-            break;
-        dir = parent;
-    }
-    files.push(...ancestors);
-    return files;
-}
 function escapeAttribute(value) {
     return value.replaceAll('&', '&amp;').replaceAll('"', '&quot;').replaceAll('<', '&lt;').replaceAll('>', '&gt;');
 }
@@ -175,18 +112,19 @@ function parseWorktrees(lines) {
     }
     return worktrees;
 }
-/** The `<project_context>` block for the files discovered from `cwd`, plus the
- *  cwd/git environment snapshot that now rides at the end of the wrapper.
- *  Always emits the wrapper because the environment snapshot is always present
- *  even when no project instructions exist. Exported for testing. */
+/** The `<project_context>` block — now just the cwd/git `<environment>`
+ *  snapshot (dir listing + git status/worktrees). This USED to also carry a
+ *  `<project_instructions>` block re-rendering the node's AGENTS.md/CLAUDE.md;
+ *  that machinery is gone (hard cut, 2026-07-06) — project guidance now lives
+ *  in the document substrate (`crtr sys sync` migrates each CLAUDE.md/AGENTS.md
+ *  into that dir's own `.crouter/memory/AGENTS.md` at content/content, so it
+ *  surfaces via the `<memory kind="knowledge">` block instead). Always emits
+ *  the wrapper because the environment snapshot is always present. Exported
+ *  for testing. */
 export function buildProjectContextBlock(cwd) {
-    const files = loadProjectContextFiles(cwd);
     const envLines = directoryListingLines(cwd);
     const git = gitSnapshot(cwd);
-    let out = '<project_context>\n\nProject-specific instructions and guidelines:\n\n';
-    for (const { path, content } of files) {
-        out += `<project_instructions path="${path}">\n${content}\n</project_instructions>\n\n`;
-    }
+    let out = '<project_context>\n\n';
     out += `<environment cwd="${escapeAttribute(cwd)}">\n`;
     out += `Directory:\n${envLines.map((line) => `  ${line}`).join('\n')}\n`;
     out += `${git.lines.map((line) => `${line}`).join('\n')}\n`;
@@ -432,9 +370,12 @@ export function buildWakeBearings(origin) {
  *      from.
  *   2. `<memory kind="knowledge">` — the consultable catalog, a SIBLING of the
  *      bearings (never nested under the context dir). Dropped when empty.
- *   3. `<project_context>` — the AGENTS.md/CLAUDE.md instructions + the cwd/git
- *      environment snapshot, moved OUT of the system prompt (pi's copy is
- *      suppressed via noContextFiles in broker.ts) so it rides this message. */
+ *   3. `<project_context>` — the cwd/git environment snapshot. pi's own
+ *      AGENTS.md/CLAUDE.md system-prompt injection stays suppressed
+ *      (noContextFiles in broker.ts); project guidance instead rides the
+ *      `<memory kind="knowledge">` block above via the document substrate
+ *      (`crtr sys sync` migrates each CLAUDE.md/AGENTS.md into that dir's own
+ *      `.crouter/memory/AGENTS.md`). */
 export function buildContextBearings(nodeId) {
     const node = getNode(nodeId);
     const bearings = ['<crtr-bearings>', buildIdentityAssertion(nodeId)];

package/dist/core/runtime/broker.js

@@ -1706,10 +1706,11 @@ export async function buildBrokerSession(engine, cfg) {
             resourceLoaderOptions: {
                 additionalExtensionPaths: cfg.extensionPaths,
                 appendSystemPrompt: cfg.appendSystemPromptPath !== undefined ? [cfg.appendSystemPromptPath] : undefined,
-                // Suppress pi's <project_context> in the SYSTEM PROMPT — crouter
-                // re-renders the same AGENTS.md/CLAUDE.md files into the first-message
-                // <crtr-context> bearings instead (buildProjectContextBlock), so all
-                // project instructions ride the user message, not the system prompt.
+                // Suppress pi's <project_context> AGENTS.md/CLAUDE.md injection in the
+                // SYSTEM PROMPT unconditionally — crouter reads project guidance through
+                // the document substrate instead (a migrated AGENTS.md doc rides the
+                // <memory kind="knowledge"> block in the first-message bearings; see
+                // bearings.ts and `crtr sys sync`), never pi's own file-based loader.
                 noContextFiles: true,
             },
         });

package/dist/core/substrate/on-read.js

@@ -9,10 +9,12 @@
 //   • POSITIONAL — walk the read file's ancestor dirs; any doc living in an
 //     ancestor PROJECT `.crouter/memory/` surfaces (a doc surfaces when a file
 //     beside/under its own project scope dir is read), UNLESS it carries an
-//     explicit read-trigger (see D5 below). This mirrors nested-context's
-//     `.claude/rules` ancestor walk, but keyed on `.crouter/memory/`. The
-//     user-global `~/.crouter/memory/` store is NOT positional; user docs only
-//     fire on reads through explicit `applies-to` / `read-when` triggers.
+//     explicit read-trigger (see D5 below). This is the substrate's own
+//     ancestor walk keyed on `.crouter/memory/` — the same shape the retired
+//     nested-context pi-extension used for `.claude/rules` before that path
+//     was migrated into substrate docs (`crtr sys sync`). The user-global
+//     `~/.crouter/memory/` store is NOT positional; user docs only fire on
+//     reads through explicit `applies-to` / `read-when` triggers.
 //   • applies-to GLOB — any RESOLVED substrate doc (user/project/builtin scope)
 //     whose `appliesTo` glob matches the read file path surfaces, regardless of
 //     where the read file sits relative to the doc.
@@ -63,8 +65,9 @@ import { cachedSubstrateDocs } from './session-cache.js';
 // is the segment we explicitly join onto each surviving ancestor).
 const JUNK_DIRS = new Set(['node_modules', '.git', 'dist', 'build', '.next', '.cache', '.yalc']);
 // ---------------------------------------------------------------------------
-// Small path helpers (mirror the on-read precedent — nested-context /
-// frontmatter-rules — so the injected envelope matches their faithful shape).
+// Small path helpers (mirror the on-read precedent — frontmatter-rules, and
+// the retired nested-context extension — so the injected envelope matches
+// their faithful shape).
 // ---------------------------------------------------------------------------
 function realpathOrSelf(p) {
     try {