@geraldmaron/construct 1.2.1 → 1.2.2

package/lib/hooks/context-window-recovery.mjs

@@ -12,9 +12,9 @@
  * @exits 0 = pass
  */
 import { readFileSync, writeFileSync, mkdirSync } from 'fs';
-import { homedir } from 'os';
 import { join } from 'path';
 import { readContextState, writeContextState } from '../context-state.mjs';
+import { doctorRoot } from '../config/xdg.mjs';
 
 const CONTEXT_LIMIT_PATTERNS = [
   'context window', 'maximum context', 'too long', 'prompt is too long',
@@ -23,7 +23,7 @@ const CONTEXT_LIMIT_PATTERNS = [
 ];
 
 const COOLDOWN_MS = 10 * 60 * 1000;
-const STATE_PATH = join(homedir(), '.cx', 'context-recovery.json');
+const STATE_PATH = join(doctorRoot(), 'context-recovery.json');
 
 let input = {};
 try { input = JSON.parse(readFileSync(0, 'utf8')); } catch { process.exit(0); }
@@ -42,7 +42,7 @@ try {
   if (now - (state.lastTriggeredAt || 0) < COOLDOWN_MS) process.exit(0);
 } catch { /* first run */ }
 
-const cxDir = join(homedir(), '.cx');
+const cxDir = doctorRoot();
 try { mkdirSync(cxDir, { recursive: true }); } catch { /* exists */ }
 try { writeFileSync(STATE_PATH, JSON.stringify({ lastTriggeredAt: now })); } catch { /* best effort */ }
 
@@ -50,7 +50,7 @@ const cwd = input?.cwd || process.cwd();
 
 let existingContext = '';
 try {
-  const state = readContextState(cwd) || readContextState(homedir());
+  const state = readContextState(cwd) || readContextState(doctorRoot());
   if (state?.markdown) existingContext = String(state.markdown).slice(0, 800);
   else if (state?.context) existingContext = String(state.context).slice(0, 800);
 } catch { /* none */ }
@@ -66,7 +66,7 @@ const recoveryContext = [
 const projectCxDir = join(cwd, '.cx');
 try { mkdirSync(projectCxDir, { recursive: true }); } catch { /* exists */ }
 try { writeContextState(cwd, { source: 'context-window-recovery', recoveryContext, format: 'json' }, { markdown: recoveryContext }); } catch { /* best effort */ }
-try { writeContextState(homedir(), { source: 'context-window-recovery', recoveryContext, format: 'json' }, { markdown: recoveryContext }); } catch { /* best effort */ }
+try { writeContextState(doctorRoot(), { source: 'context-window-recovery', recoveryContext, format: 'json' }, { markdown: recoveryContext }); } catch { /* best effort */ }
 
 process.stdout.write([
   ``,

package/lib/hooks/dep-audit.mjs

@@ -15,10 +15,10 @@
  */
 import { readFileSync, existsSync } from 'node:fs';
 import { execSync } from 'node:child_process';
-import { homedir } from 'node:os';
 import { join, dirname, basename } from 'node:path';
 import { appendBounded } from '../logging/rotate.mjs';
 import { logHookFailure } from './_lib/log.mjs';
+import { doctorRoot } from '../config/xdg.mjs';
 
 const filePath = process.env.TOOL_INPUT_FILE_PATH || '';
 if (!filePath) process.exit(0);
@@ -31,7 +31,7 @@ if (!MANIFESTS.has(file)) process.exit(0);
 if (/node_modules|\/dist\/|\/build\/|\/\.git\//.test(filePath)) process.exit(0);
 
 const projectDir = dirname(filePath);
-const warnFlagsPath = join(homedir(), '.cx', 'warn-flags.txt');
+const warnFlagsPath = join(doctorRoot(), 'warn-flags.txt');
 
 function appendWarn(msg) {
   try { appendBounded('bash-warn-flags', warnFlagsPath, msg + '\n'); }

package/lib/hooks/doc-coupling-check.mjs

@@ -19,10 +19,11 @@
  */
 
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
-import { homedir } from 'node:os';
 import { join, dirname } from 'node:path';
 
-const STATE_PATH = join(homedir(), '.cx', 'doc-coupling.json');
+import { doctorRoot } from '../config/xdg.mjs';
+
+const STATE_PATH = join(doctorRoot(), 'doc-coupling.json');
 const CODE_RE = /^(lib|bin|src|app)\/.*\.(?:m?js|jsx?|tsx?|cjs)$/;
 const DOC_RE = /^(?:CHANGELOG\.md|docs\/.+\.md|\.cx\/context\.(?:md|json))$/;
 const THRESHOLDS = [3, 5, 10];

package/lib/hooks/edit-accumulator.mjs

@@ -20,6 +20,7 @@ import { homedir } from 'node:os';
 import path from 'node:path';
 import { appendBounded } from '../logging/rotate.mjs';
 import { logHookFailure } from './_lib/log.mjs';
+import { doctorRoot } from '../config/xdg.mjs';
 
 const TS_EXTS = new Set(['.ts','.tsx','.js','.mjs','.jsx','.cjs']);
 const filePath = process.env.TOOL_INPUT_FILE_PATH || '';
@@ -28,7 +29,7 @@ if (!filePath) process.exit(0);
 
 const ext = path.extname(filePath);
 const home = homedir();
-const countPath = path.join(home, '.cx', 'files-changed-count.txt');
+const countPath = path.join(doctorRoot(home), 'files-changed-count.txt');
 
 // Always increment the total files-changed counter for notify
 try {
@@ -41,7 +42,7 @@ try {
 // Only accumulate TS/JS files for typecheck
 if (!TS_EXTS.has(ext)) process.exit(0);
 
-const tcPath = path.join(home, '.cx', 'pending-typecheck.txt');
+const tcPath = path.join(doctorRoot(home), 'pending-typecheck.txt');
 try {
   const existing = existsSync(tcPath) ? readFileSync(tcPath, 'utf8').split('\n').filter(Boolean) : [];
   if (!existing.includes(filePath)) {

package/lib/hooks/edit-guard.mjs

@@ -14,10 +14,10 @@
 import { readFileSync, existsSync } from 'fs';
 import { createHash } from 'crypto';
 import { join, resolve } from 'path';
-import { homedir } from 'os';
 import { logHookFailure } from './_lib/log.mjs';
+import { doctorRoot } from '../config/xdg.mjs';
 
-const HASH_STORE = join(homedir(), '.cx', 'file-hashes.json');
+const HASH_STORE = join(doctorRoot(), 'file-hashes.json');
 
 function storedHash(absPath) {
   try {
@@ -48,7 +48,7 @@ function absOf(p) { return p.startsWith('/') ? p : resolve(cwd, p); }
 
 if ((toolName === 'Edit' || toolName === 'Write' || toolName === 'MultiEdit') && process.env.CONSTRUCT_ROLES !== 'off') {
   try {
-    const lastAgentPath = join(homedir(), '.cx', 'last-agent.json');
+    const lastAgentPath = join(doctorRoot(), 'last-agent.json');
     if (existsSync(lastAgentPath)) {
       const last = JSON.parse(readFileSync(lastAgentPath, 'utf8'));
       const lastTs = last?.ts ? Date.parse(last.ts) : 0;

package/lib/hooks/guard-bash.mjs

@@ -13,9 +13,9 @@
  */
 import { createInterface } from 'readline';
 import { readFileSync, existsSync } from 'fs';
-import { homedir } from 'os';
 import { join } from 'path';
 import { logHookFailure } from './_lib/log.mjs';
+import { doctorRoot } from '../config/xdg.mjs';
 
 const BLOCK_PATTERNS = [
   {
@@ -99,7 +99,7 @@ for (const { pattern, reason } of WARN_PATTERNS) {
 
 if (process.env.CONSTRUCT_ROLES !== 'off') {
   try {
-    const cxDir = join(homedir(), '.cx');
+    const cxDir = doctorRoot();
     const id = String(process.env.CONSTRUCT_AGENT_ID || '').replace(/^cx-/, '');
     let agentData = null;
 

package/lib/hooks/model-fallback.mjs

@@ -32,8 +32,9 @@ import {
   writeProviderCooldown,
 } from '../model-router.mjs';
 import { readHookInput } from './_lib/input.mjs';
+import { doctorRoot } from '../config/xdg.mjs';
 
-const cooldownPath = join(homedir(), '.cx', 'provider-cooldowns.json');
+const cooldownPath = join(doctorRoot(), 'provider-cooldowns.json');
 const envPath = join(process.cwd(), '.env');
 
 const input = readHookInput();

package/lib/hooks/policy-engine.mjs

@@ -24,6 +24,7 @@ import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
 import { execSync } from 'node:child_process';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
+import { doctorRoot } from '../config/xdg.mjs';
 
 let input = {};
 try { input = JSON.parse(readFileSync(0, 'utf8')) || {}; } catch { process.exit(0); }
@@ -55,7 +56,7 @@ if (hookEvent === 'PreToolUse') {
   const READ_TOOLS = new Set(['Read', 'Grep', 'Glob', 'LS', 'NotebookRead']);
   const BLOCKED_TOOLS = new Set(['Write', 'Edit', 'MultiEdit', 'NotebookEdit', 'TodoWrite']);
 
-  const stateDir = join(home, '.cx');
+  const stateDir = doctorRoot(home);
   const statePath = join(stateDir, 'bootstrap-state.json');
   const sessionId = input.session_id || input.sessionId || 'default';
 
@@ -147,7 +148,7 @@ if (hookEvent === 'Stop') {
 
   const branch = safeExec('git branch --show-current');
   const isFeatureBranch = branch && branch !== 'main' && branch !== 'dev' && branch !== 'master';
-  const filesChangedPath = join(home, '.cx', 'files-changed-count.txt');
+  const filesChangedPath = join(doctorRoot(home), 'files-changed-count.txt');
   let filesChanged = 0;
   try { filesChanged = parseInt(readFileSync(filesChangedPath, 'utf8').trim() || '0', 10); } catch {}
 
@@ -188,7 +189,7 @@ if (hookEvent === 'Stop') {
     }
   }
 
-  const driveSessionPath = join(home, '.cx', 'drive-session.json');
+  const driveSessionPath = join(doctorRoot(home), 'drive-session.json');
   if (existsSync(driveSessionPath)) {
     let ds = {};
     try { ds = JSON.parse(readFileSync(driveSessionPath, 'utf8')); } catch {}

package/lib/hooks/pre-compact.mjs

@@ -17,10 +17,10 @@
  * @exits 0 = pass
  */
 import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
-import { homedir } from 'os';
 import { join } from 'path';
 import { writeContextState, contextMarkdownPath, contextJsonPath } from '../context-state.mjs';
 import { flushReadTrackerDeltas } from '../read-tracker-store.mjs';
+import { doctorRoot } from '../config/xdg.mjs';
 
 // Section headings that are auto-generated by this hook. Any other heading in
 // the existing context.md is treated as manually authored and preserved.
@@ -100,8 +100,8 @@ const transcriptPath = input?.transcript_path || '';
 const filesChanged = [];
 const decisions = [];
 const pendingTodos = [];
-const warnFlagsPath = join(homedir(), '.cx', 'warn-flags.txt');
-const efficiencyPath = join(homedir(), '.cx', 'session-efficiency.json');
+const warnFlagsPath = join(doctorRoot(), 'warn-flags.txt');
+const efficiencyPath = join(doctorRoot(), 'session-efficiency.json');
 let lastSummary = '';
 
 if (transcriptPath && existsSync(transcriptPath)) {
@@ -275,12 +275,12 @@ if (decisions.length) {
   try { writeFileSync(join(decisionsDir, `${slug}.md`), decisionDoc); } catch { /* best effort */ }
 }
 
-const globalCxDir = join(homedir(), '.cx');
+const globalCxDir = join(doctorRoot(), '.cx');
 try { mkdirSync(globalCxDir, { recursive: true }); } catch { /* exists */ }
-const globalMdPath = contextMarkdownPath(homedir());
+const globalMdPath = contextMarkdownPath(doctorRoot());
 const globalManualSections = extractManualSections(globalMdPath);
 const globalFinalContent = content + (globalManualSections ? '\n' + globalManualSections : '');
-const globalMergedJson = mergeExistingJson(contextJsonPath(homedir()), contextJson);
-try { writeContextState(homedir(), { ...globalMergedJson, contextSummary: lastSummary }, { markdown: globalFinalContent }); } catch { /* best effort */ }
+const globalMergedJson = mergeExistingJson(contextJsonPath(doctorRoot()), contextJson);
+try { writeContextState(doctorRoot(), { ...globalMergedJson, contextSummary: lastSummary }, { markdown: globalFinalContent }); } catch { /* best effort */ }
 
 process.exit(0);

package/lib/hooks/readme-age-check.mjs

@@ -17,11 +17,11 @@
 
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { execSync } from 'node:child_process';
-import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { emitRoleEvent } from '../roles/hook-emit.mjs';
+import { doctorRoot } from '../config/xdg.mjs';
 
-const STATE_PATH = join(homedir(), '.cx', 'readme-age-state.json');
+const STATE_PATH = join(doctorRoot(), 'readme-age-state.json');
 const STALE_DAYS = 90;
 const SUPPRESS_DAYS = 7;
 

package/lib/hooks/session-optimize.mjs

@@ -14,18 +14,19 @@
  */
 import { readFileSync, existsSync, writeFileSync, mkdirSync, readdirSync, statSync } from 'fs';
 import { join, dirname } from 'path';
-import { homedir } from 'os';
 import { spawn } from 'child_process';
 import { fileURLToPath } from 'url';
 
+import { doctorRoot } from '../config/xdg.mjs';
+
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const CONSTRUCT_BIN = join(__dirname, '..', '..', 'bin', 'construct');
 
 const OPTIMIZATION_THRESHOLD = 0.7;
 const MIN_TRACES_PER_AGENT = 3;
 const OPTIMIZATION_DAYS = 7;
-const OPTIMIZATION_LOG_DIR = join(homedir(), '.cx', 'optimization-logs');
-const REVIEWS_DIR = join(homedir(), '.cx', 'performance-reviews');
+const OPTIMIZATION_LOG_DIR = join(doctorRoot(), 'optimization-logs');
+const REVIEWS_DIR = join(doctorRoot(), 'performance-reviews');
 
 mkdirSync(OPTIMIZATION_LOG_DIR, { recursive: true });
 

package/lib/hooks/session-start.mjs

@@ -24,6 +24,7 @@ import { listObservations, searchObservations } from '../observation-store.mjs';
 import { countEntities } from '../entity-store.mjs';
 import { logHookFailure } from './_lib/log.mjs';
 import { resolveHookOutputMode, writeHookContext } from './_lib/output-mode.mjs';
+import { doctorRoot } from '../config/xdg.mjs';
 
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 const CONSTRUCT_BIN = resolve(MODULE_DIR, '..', '..', 'bin', 'construct');
@@ -64,11 +65,11 @@ function fileIsFresh(path) {
 // stale context files inject only the digest line as fallback (Tier 2 → Tier 1
 // degradation), full body only when modified within the freshness window.
 const localCtx = join(cwd, '.cx', 'context.md');
-const globalCtx = join(homedir(), '.cx', 'context.md');
+const globalCtx = join(doctorRoot(), '.cx', 'context.md');
 let context = '';
 let contextStale = false;
 const localState = readContextState(cwd);
-const globalState = localState ? null : readContextState(homedir());
+const globalState = localState ? null : readContextState(doctorRoot());
 const stateContext = localState || globalState;
 const stateContextPath = localState ? localCtx : globalCtx;
 if (stateContext?.markdown) {
@@ -151,7 +152,7 @@ try {
 
 // Record memory injection stats for the Stop hook to persist into .cx/memory-stats.jsonl.
 try {
-  const memStatsPath = join(homedir(), '.cx', 'session-memory-stats.json');
+  const memStatsPath = join(doctorRoot(), 'session-memory-stats.json');
   const injected = observationsNote ? (observationsNote.match(/^- /gm) || []).length : 0;
   writeFileSync(memStatsPath, JSON.stringify({
     project: projectName,
@@ -162,7 +163,7 @@ try {
 } catch { /* best effort */ }
 
 // Pending typecheck warning
-const tcPath = join(homedir(), '.cx', 'pending-typecheck.txt');
+const tcPath = join(doctorRoot(), 'pending-typecheck.txt');
 let pendingNote = '';
 try {
   const pending = existsSync(tcPath) ? readFileSync(tcPath, 'utf8').split('\n').filter(Boolean) : [];
@@ -400,7 +401,7 @@ try {
 try {
   const sessionId = input?.session_id || input?.sessionId;
   if (sessionId) {
-    const bootstrapPath = join(homedir(), ".cx", "bootstrap-state.json");
+    const bootstrapPath = join(doctorRoot(), "bootstrap-state.json");
     let state = {};
     try { state = JSON.parse(readFileSync(bootstrapPath, "utf8")) || {}; } catch {}
     const now = Date.now();

package/lib/hooks/stop-notify.mjs

@@ -27,6 +27,7 @@ import { captureSessionArtifacts } from '../artifact-capture.mjs';
 import { appendSessionStats } from '../memory-stats.mjs';
 import { estimateUsageCost } from '../telemetry/model-pricing-catalog.mjs';
 import { flushReadTrackerDeltas } from '../read-tracker-store.mjs';
+import { doctorRoot } from '../config/xdg.mjs';
 
 function loadTranscriptCheckpoints(checkpointPath) {
   try {
@@ -148,12 +149,12 @@ if (raw) process.stdout.write(raw);
 try { flushReadTrackerDeltas({ env: process.env }); } catch { /* non-critical */ }
 
 const home = homedir();
-const tsResultPath = join(home, '.cx', 'ts-result.txt');
-const warnFlagsPath = join(home, '.cx', 'warn-flags.txt');
-const countPath = join(home, '.cx', 'files-changed-count.txt');
-const costLogPath = join(home, '.cx', 'session-cost.jsonl');
-const lastAgentPath = join(home, '.cx', 'last-agent.json');
-const checkpointPath = join(home, '.cx', 'transcript-checkpoints.json');
+const tsResultPath = join(doctorRoot(home), 'ts-result.txt');
+const warnFlagsPath = join(doctorRoot(home), 'warn-flags.txt');
+const countPath = join(doctorRoot(home), 'files-changed-count.txt');
+const costLogPath = join(doctorRoot(home), 'session-cost.jsonl');
+const lastAgentPath = join(doctorRoot(home), 'last-agent.json');
+const checkpointPath = join(doctorRoot(home), 'transcript-checkpoints.json');
 
 // Consume-clear like warn-flags/files-changed below: a TS result is reported
 // once, not re-fired on every subsequent no-op Stop. stop-typecheck rewrites
@@ -304,7 +305,7 @@ try {
   }
 } catch { /* non-critical */ }
 
-const memStatsPath = join(home, '.cx', 'session-memory-stats.json');
+const memStatsPath = join(doctorRoot(home), 'session-memory-stats.json');
 try {
   if (existsSync(memStatsPath)) {
     const memStats = JSON.parse(readFileSync(memStatsPath, 'utf8'));
@@ -323,7 +324,7 @@ try {
 // repeat Stop events within the window to avoid review-spam.
 try {
   const homeDir = process.env.HOME || homedir();
-  const stampPath = join(homeDir, '.cx', 'performance-reviews', '.last-run');
+  const stampPath = join(doctorRoot(homeDir), 'performance-reviews', '.last-run');
   let lastRun = 0;
   try { lastRun = Number(readFileSync(stampPath, 'utf8')) || 0; } catch { /* fresh */ }
   if (Date.now() - lastRun > 24 * 60 * 60 * 1000) {

package/lib/hooks/stop-typecheck.mjs

@@ -15,6 +15,7 @@ import { readFileSync, writeFileSync, existsSync } from 'fs';
 import { execSync } from 'child_process';
 import { homedir } from 'os';
 import { join, dirname } from 'path';
+import { doctorRoot } from '../config/xdg.mjs';
 
 // Stop hooks must echo stdin to stdout
 let raw = '';
@@ -22,9 +23,9 @@ try { raw = readFileSync(0, 'utf8'); } catch { /* no stdin */ }
 if (raw) process.stdout.write(raw);
 
 const home = homedir();
-const tcPath = join(home, '.cx', 'pending-typecheck.txt');
-const tsResultPath = join(home, '.cx', 'ts-result.txt');
-const warnFlagsPath = join(home, '.cx', 'warn-flags.txt');
+const tcPath = join(doctorRoot(home), 'pending-typecheck.txt');
+const tsResultPath = join(doctorRoot(home), 'ts-result.txt');
+const warnFlagsPath = join(doctorRoot(home), 'warn-flags.txt');
 
 // Read pending files
 const pending = existsSync(tcPath)

package/lib/hooks/test-watch.mjs

@@ -15,10 +15,10 @@
  */
 
 import { readFileSync, existsSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { logHookFailure } from './_lib/log.mjs';
 import { emitRoleEvent } from '../roles/hook-emit.mjs';
+import { doctorRoot } from '../config/xdg.mjs';
 
 let input = {};
 try { input = JSON.parse(readFileSync(0, 'utf8')); }
@@ -44,7 +44,7 @@ emitRoleEvent({
   context: { command, exitCode, failedNames },
 });
 
-const flakeTrackerPath = join(homedir(), '.cx', 'test-watch-state.json');
+const flakeTrackerPath = join(doctorRoot(), 'test-watch-state.json');
 try {
   const state = existsSync(flakeTrackerPath) ? JSON.parse(readFileSync(flakeTrackerPath, 'utf8')) : {};
   const now = Date.now();

package/lib/host-disposition.mjs

@@ -2,7 +2,7 @@
  * lib/host-disposition.mjs — single source of truth for the disposition of
  * every artifact Construct creates in a host project (ADR-0027 §1).
  *
- * Scope model (see docs/concepts/project-scopes.md):
+ * Scope model (see docs/guides/concepts/project-scopes.md):
  *   templates/, docs/  — package/repo durable sources (committed)
  *   .construct/        — per-project launcher (ignored)
  *   .cx/               — per-project runtime: intake, oracle, observations, demos (ignored)

package/lib/ingest/provider-extract.mjs

@@ -24,6 +24,7 @@
 import { readFileSync, existsSync } from 'node:fs';
 import { extname, join } from 'node:path';
 import { homedir } from 'node:os';
+import { configDir } from '../config/xdg.mjs';
 
 import {
   AUDIO_VIDEO_EXTS,
@@ -75,7 +76,7 @@ function isAnthropic(provider, model) {
 function resolveKey(varName, env, allowAmbient) {
   if (env[varName] && typeof env[varName] === 'string' && env[varName].length > 0) return env[varName];
   if (!allowAmbient) return null;
-  for (const file of [join(homedir(), '.construct', 'config.env'), join(homedir(), '.env')]) {
+  for (const file of [join(configDir(), 'config.env'), join(homedir(), '.env')]) {
     try {
       if (!existsSync(file)) continue;
       const m = readFileSync(file, 'utf8').match(new RegExp(`^${varName}=["']?(.+?)["']?$`, 'm'));

package/lib/init/detect-existing-structure.mjs

@@ -12,13 +12,13 @@
  *
  * Heuristics intentionally err on the side of "skip" — a directory is treated
  * as a real lane only when it carries at least one markdown file. An empty
- * docs/meetings/ that an earlier init scaffolded does NOT register; that lets
+ * docs/notes/meetings/ that an earlier init scaffolded does NOT register; that lets
  * re-running init be a no-op rather than a contradictory "skip what we just
  * created" message.
  *
  * Issue #97 motivates this: `construct init` on an existing project with
  * `internal/meetings/`, a custom `ingest` script, and root-level `templates/`
- * created `docs/meetings/`, `.cx/inbox/`, and per-lane `templates/` folders
+ * created `docs/notes/meetings/`, `inbox/`, and per-lane `templates/` folders
  * that conflicted with the existing workflow.
  */
 

package/lib/init/doc-lanes.mjs

@@ -32,12 +32,6 @@ export const DOC_LANES = {
     description: 'User-facing release notes and version history entries.',
     templates: ['changelog-entry.md'],
   },
-  intake: {
-    title: 'Intake',
-    dir: 'intake',
-    description: 'Intake batch records that explain what arrived, why it matters, and how it should be ingested.',
-    templates: ['__intake-template__'],
-  },
   memos: {
     title: 'Memos',
     dir: 'memos',
@@ -88,11 +82,11 @@ export const DOC_LANES = {
   },
 };
 
-export const LANE_ORDER = ['adrs', 'briefs', 'changelogs', 'intake', 'memos', 'meetings', 'notes', 'onboarding', 'postmortems', 'prds', 'rfcs', 'runbooks'];
+export const LANE_ORDER = ['adrs', 'briefs', 'changelogs', 'memos', 'meetings', 'notes', 'onboarding', 'postmortems', 'prds', 'rfcs', 'runbooks'];
 
 export const DOC_PRESETS = {
-  lean: ['adrs', 'intake', 'memos', 'meetings', 'notes', 'prds'],
-  product: ['adrs', 'intake', 'memos', 'meetings', 'notes', 'prds', 'rfcs'],
+  lean: ['adrs', 'memos', 'meetings', 'notes', 'prds'],
+  product: ['adrs', 'memos', 'meetings', 'notes', 'prds', 'rfcs'],
   full: LANE_ORDER,
 };
 
@@ -107,7 +101,6 @@ export const LANE_ALIASES = {
   changelogs: 'changelogs',
   releases: 'changelogs',
   release: 'changelogs',
-  intake: 'intake',
   memo: 'memos',
   memos: 'memos',
   meeting: 'meetings',

package/lib/init-docs.mjs

@@ -3,8 +3,8 @@
  * lib/init-docs.mjs — stand up a documentation system for a project.
  *
  * Intentionally separate from `construct init`. Creates the docs surface only:
- * docs/README.md plus selected lane directories such as docs/adr/, docs/intake/,
- * docs/memos/, docs/notes/, docs/prds/, and docs/rfcs/ with starter templates
+ * docs/README.md plus selected lane directories such as docs/decisions/adr/, docs/intake/,
+ * docs/notes/memos/, docs/notes/, templates/docs/prds/, and templates/docs/rfcs/ with starter templates
  * copied into per-lane templates/ directories from Construct's template library.
  *
  * Usage:
@@ -290,15 +290,6 @@ function buildLaneReadme(laneKey) {
     const filename = index === 0 ? "_template.md" : templateName.replace(/\.md$/, ".template.md");
     return `- [${filename}](./templates/${filename})`;
   });
-  const usageSection = laneKey === "intake"
-    ? `
-## Intake flow
-
-- Drop source files into either [\`.cx/inbox/\`](../../.cx/inbox/) or this lane's directory when you want Construct to ingest them.
-- Run \`construct ingest ./docs/intake --sync\` or \`construct ingest ./.cx/inbox --sync\` to convert supported files into retrieval-ready markdown, or let the embed daemon watch those drop zones automatically.
-- Durable ingested knowledge lands under \`.cx/knowledge/internal/\` by default, which is where Construct's learning and search paths already operate.
-`
-    : "";
 
   return `<!--
 docs/${dirName}/README.md — lane guide for ${title}.
@@ -314,7 +305,6 @@ ${description}
 ## Starter templates
 
 ${templateLines.join("\n")}
-${usageSection}
 `;
 }
 
@@ -432,39 +422,6 @@ Promote durable decisions into ADRs, memos, or PRDs when needed.
 `;
 }
 
-function buildIntakeTemplate() {
-  return `<!--
-docs/intake/templates/_template.md — starter template for logging an intake batch.
-
-Use this when you want a durable record of what was dropped into intake and why.
-Raw source files belong in .cx/inbox/ until they are ingested.
--->
-
-# Intake Batch: {title}
-
-- **Date**: {YYYY-MM-DD}
-- **Owner**: {name}
-- **Source**: {vendor, teammate, export, upload}
-
-## What arrived
-
-<!-- Files, folders, or links dropped into .cx/inbox/. -->
-
-## Why it matters
-
-<!-- Why Construct should ingest this material. -->
-
-## Ingest plan
-
-- Run: \`construct ingest ./.cx/inbox --sync\`
-- Target: \`.cx/knowledge/internal/\` unless a different knowledge target is more appropriate
-
-## Notes
-
-<!-- Caveats, access concerns, or cleanup notes. -->
-`;
-}
-
 function titleCase(value) {
   return value
     .split(/[-_\s]+/)
@@ -532,7 +489,6 @@ function copyLaneTemplates(laneKey) {
     const content =
       templateName === "__notes-template__" ? buildNotesTemplate()
       : templateName === '__meeting-notes-template__' ? buildMeetingNotesTemplate()
-      : templateName === "__intake-template__" ? buildIntakeTemplate()
       : fs.readFileSync(path.join(TEMPLATE_DIR, templateName), "utf8");
     writeIfMissing(path.join(laneRoot, "templates", outputName), content);
   }
@@ -632,14 +588,16 @@ async function main() {
   if (withArchitecture) {
     writeIfMissing(path.join(docsDir, "architecture.md"), buildArchitectureDoc(projectName, allScaffoldedLaneKeys));
   }
-  if (lanesToScaffold.includes('intake')) {
-    const inboxDecision = shouldSkipProjectInbox(detection, { force: forceScaffold });
-    if (inboxDecision.skip) {
-      process.stdout.write(`[init:docs] skipping .cx/inbox/ — ${inboxDecision.reason}. Run with --force to scaffold anyway.\n`);
-      skipped.push('.cx/inbox/ (deferred to existing intake)');
-    } else {
-      fs.mkdirSync(path.join(target, '.cx', 'inbox'), { recursive: true });
-    }
+  const inboxDecision = shouldSkipProjectInbox(detection, { force: forceScaffold });
+  if (inboxDecision.skip) {
+    process.stdout.write(`[init:docs] skipping inbox/ — ${inboxDecision.reason}. Run with --force to scaffold anyway.\n`);
+    skipped.push('inbox/ (deferred to existing intake)');
+  } else {
+    // Single canonical drop zone (ADR-0045 §C): the project-root inbox/, with
+    // a gitignored .staging/ for atomic rename-in handoff. Independent of any
+    // docs lane.
+
+    fs.mkdirSync(path.join(target, 'inbox', '.staging'), { recursive: true });
   }
 
   for (const { laneKey, reason } of deferredLanes) {