@geraldmaron/construct 1.0.1 → 1.0.2

package/.env.example

@@ -46,7 +46,7 @@ OPENROUTER_TITLE=Your App Name
 # The installer can auto-configure local memory or let you skip/manualize it.
 
 # ─── Hybrid Retrieval Backend ─────────────────────────────────────────────────
-# `construct init --yes` writes managed defaults automatically. When Docker is
+# `construct setup --yes` writes managed defaults automatically. When Docker is
 # available, it starts a localhost-only Postgres container on 127.0.0.1:54329.
 #
 # Shared Postgres store for team-ready state/querying

package/bin/construct

@@ -130,7 +130,7 @@ function usage() {
 
 /** Show interactive context-aware menu when construct is run without arguments. */
 async function showInteractiveMenu() {
-  const { loadProjectConfig } = await import('../lib/config/project-config.mjs');
+  const { loadProjectConfig } = await import('./lib/config/project-config.mjs');
   const { existsSync } = await import('node:fs');
   const { join } = await import('node:path');
   
@@ -142,7 +142,7 @@ async function showInteractiveMenu() {
   println('');
   
   if (isConstructProject) {
-    const projectName = process.env.CX_PROJECT_NAME || path.basename(projectRoot);
+    const projectName = process.env.CX_PROJECT_NAME || require('path').basename(projectRoot);
     println(`${COLORS.dim}Project:${COLORS.reset} ${projectName}`);
     println('');
   }
@@ -1789,8 +1789,8 @@ async function cmdIntakeConfig(args) {
 async function cmdIntakeMetrics() {
   try {
     const { computeIntakeMetrics, pendingAge } = await import('../lib/embed/intake-metrics.mjs');
-    const metrics = computeIntakeMetrics({ rootDir: process.cwd() });
-    const age = pendingAge({ rootDir: process.cwd() });
+    const metrics = computeIntakeMetrics({ rootDir: cwd });
+    const age = pendingAge({ rootDir: cwd });
 
     println(`${COLORS.bold}Intake pipeline metrics:${COLORS.reset}`);
     println('');

package/bin/construct-postinstall.mjs

@@ -6,7 +6,7 @@
  * and runs `npm install`, npm fetches Construct into the project's
  * `node_modules/` and then runs this script. Its job: regenerate the project's
  * `.claude/agents/` and `.claude/settings.json` from the bundled registry so
- * the project clone is fully runnable without a manual `construct init`.
+ * the project clone is fully runnable without a manual `construct setup`.
  *
  * The script is a no-op in three cases:
  *

package/lib/bootstrap/resources.mjs

@@ -15,7 +15,7 @@
  *   downloadSize  approximate install size in bytes (informational)
  *
  * The registry is consulted by:
- *   - `construct init`         walks every resource, asks consent, installs
+ *   - `construct setup`         walks every resource, asks consent, installs
  *   - `construct doctor --bootstrap`  re-probes every resource verbosely
  *   - lazy-install paths in hooks (consult the cached consent silently)
  *
@@ -114,7 +114,7 @@ export function formatProbe(probe) {
     ? `\n     fallback: ${probe.fallback}`
     : '';
   const install = !probe.present && probe.installable
-    ? `\n     installable via construct init`
+    ? `\n     installable via construct setup`
     : '';
   return `  ${status}  ${probe.displayName}${v}${loc}${detail}${fallback}${install}`;
 }

package/lib/init-unified.mjs

@@ -591,108 +591,6 @@ async function askDocumentationQuestions() {
   return { lanes: selectedLanes, withArchitecture, withReadme };
 }
 
-// Intake collection — suggest directories to watch for context
-function discoverProjectDirs(targetPath) {
-  const dirs = [];
-  let entries;
-  try { entries = fs.readdirSync(targetPath, { withFileTypes: true }); } catch { return dirs; }
-  
-  for (const entry of entries) {
-    if (!entry.isDirectory()) continue;
-    const name = entry.name;
-    // Skip hidden dirs, node_modules, build artifacts
-    if (name.startsWith('.')) continue;
-    if (name === 'node_modules') continue;
-    if (name === 'dist' || name === 'build' || name === '.next' || name === '.out') continue;
-    dirs.push(name);
-  }
-  return dirs.sort();
-}
-
-const INTAKE_DIR_PRESETS = [
-  { value: 'src', label: 'src/', reason: 'Source code — most projects put code here' },
-  { value: 'lib', label: 'lib/', reason: 'Library code' },
-  { value: 'packages', label: 'packages/', reason: 'Monorepo packages' },
-  { value: 'services', label: 'services/', reason: 'Microservices or backend services' },
-  { value: 'apps', label: 'apps/', reason: 'Monorepo apps' },
-  { value: 'docs', label: 'docs/', reason: 'Documentation source' },
-  { value: 'tests', label: 'tests/', reason: 'Test files' },
-  { value: 'spec', label: 'spec/', reason: 'Specifications' },
-  { value: 'infra', label: 'infra/', reason: 'Infrastructure code (Terraform, etc.)' },
-  { value: 'config', label: 'config/', reason: 'Configuration files' },
-  { value: 'scripts', label: 'scripts/', reason: 'Build/ops scripts' },
-  { value: 'tools', label: 'tools/', reason: 'Internal tooling' },
-];
-
-async function askIntakeCollection(targetPath, skipInteractive) {
-  if (skipInteractive) {
-    // Non-interactive: auto-detect and suggest based on what exists
-    const existingDirs = discoverProjectDirs(targetPath);
-    const selected = INTAKE_DIR_PRESETS
-      .filter(preset => existingDirs.includes(preset.value))
-      .map(p => p.value);
-    
-    if (selected.length === 0) return null;
-    
-    console.log('');
-    console.log('═══════════════════════════════════════════════════════════');
-    console.log('  INTAKE COLLECTION');
-    console.log('═══════════════════════════════════════════════════════════');
-    console.log('');
-    console.log(`Auto-detected ${selected.length} directory(ies) to watch for context:`);
-    for (const d of selected) console.log(`  • ${d}/`);
-    console.log('');
-    console.log('The inbox watcher will scan these directories for new files');
-    console.log('and route them through R&D triage automatically.');
-    console.log('');
-    
-    return { parentDirs: selected, maxDepth: 4 };
-  }
-  
-  // Interactive mode
-  const existingDirs = discoverProjectDirs(targetPath);
-  const presetOptions = INTAKE_DIR_PRESETS.map(p => ({
-    label: p.label,
-    value: p.value,
-    checked: existingDirs.includes(p.value),
-    description: p.reason,
-  }));
-  
-  console.log('');
-  console.log('═══════════════════════════════════════════════════════════');
-  console.log('  INTAKE COLLECTION');
-  console.log('═══════════════════════════════════════════════════════════');
-  console.log('');
-  console.log('Intake watches directories for new files and routes them');
-  console.log('through R&D triage. Select which directories to watch.');
-  console.log('(directories already found in your project are pre-checked)');
-  console.log('');
-  
-  const selected = await multiSelect({
-    title: 'Directories to Watch',
-    instructions: 'Press Enter to confirm your selection',
-    options: presetOptions,
-  });
-  
-  if (selected.length === 0) {
-    console.log('');
-    console.log('No directories selected. The inbox watcher will only scan');
-    console.log('.cx/inbox/ and docs/intake/ (built-in zones).');
-    console.log('');
-    console.log('You can always add more later with:');
-    console.log('  construct intake config set --add-dir=src');
-    console.log('');
-    return null;
-  }
-  
-  console.log('');
-  console.log(`Watching ${selected.length} directory(ies):`);
-  for (const d of selected) console.log(`  • ${d}/`);
-  console.log('');
-  
-  return { parentDirs: selected, maxDepth: 4 };
-}
-
 function buildProjectReadme(projectName) {
   return `# ${projectName}
 
@@ -926,20 +824,6 @@ async function main() {
     console.log('');
   }
   
-  // Intake collection — ask which directories to watch for context
-  console.log('[TRACE init:intake-ask]');
-  
-  const intakeConfig = await askIntakeCollection(target, skipInteractive);
-  if (intakeConfig) {
-    const { saveIntakeConfig } = await import('./intake/intake-config.mjs');
-    try {
-      saveIntakeConfig(target, intakeConfig);
-      created.push('.cx/intake-config.json');
-    } catch (err) {
-      console.warn(`⚠️  Could not write intake config: ${err.message}`);
-    }
-  }
-  
   // Ask about documentation system
   console.log('[TRACE init:docs-ask]');
   
@@ -1011,7 +895,7 @@ async function main() {
   // can compare new intake against established PRDs/RFCs/ADRs from day
   // one. Best-effort: skipped silently when Postgres + embedding model
   // aren't ready yet (DATABASE_URL unset, no ONNX cache). User can re-run
-  // `construct ingest` or `construct init` later to seed manually.
+  // `construct ingest` or `construct setup` later to seed manually.
 
   try {
     const { syncFileStateToSql } = await import('./storage/sync.mjs');

package/lib/install/first-invocation.mjs

@@ -10,7 +10,7 @@
  *   2. Otherwise, run `probeAll()` from lib/bootstrap/resources.mjs.
  *   3. If everything's healthy → silent, set BOOTSTRAP_CHECKED=1.
  *   4. If anything's missing → print the status table to stderr; on TTY,
- *      prompt to run `construct init` now. Always set BOOTSTRAP_CHECKED=1
+ *      prompt to run `construct setup` now. Always set BOOTSTRAP_CHECKED=1
  *      so we don't re-prompt on subsequent commands.
  *
  * Skipped entirely for hook invocations (would corrupt hook output), for
@@ -71,14 +71,14 @@ export async function maybeFirstInvocationProbe({
   for (const probe of probes) stdout.write(formatProbeFn(probe) + '\n');
 
   if (missingRequired.length > 0) {
-    stdout.write(`\n[construct] ${missingRequired.length} required resource(s) missing. Run \`construct init\` to install.\n\n`);
+    stdout.write(`\n[construct] ${missingRequired.length} required resource(s) missing. Run \`construct setup\` to install.\n\n`);
   } else {
-    stdout.write(`\n[construct] ${missingOptional.length} optional resource(s) missing. Run \`construct init\` to install (Postgres, telemetry, embedding model), or continue in degraded mode.\n\n`);
+    stdout.write(`\n[construct] ${missingOptional.length} optional resource(s) missing. Run \`construct setup\` to install (Postgres, telemetry, embedding model), or continue in degraded mode.\n\n`);
   }
 
   if (stdin.isTTY && stdout.isTTY !== false) {
     const wants = await promptYesNo({
-      question: 'Run `construct init` now?',
+      question: 'Run `construct setup` now?',
       defaultYes: missingRequired.length > 0,
       readlineModule,
       stdin,

package/lib/intake/queue.mjs

@@ -73,7 +73,7 @@ export function createIntakeQueue(rootDir, env = process.env, opts = {}) {
   if (backend === 'postgres') {
     const sql = opts.sql ?? createSqlClient(env);
     if (!sql) {
-      throw new Error('Postgres intake queue requires a configured DATABASE_URL (or sql client). Run `construct init` or set CONSTRUCT_INTAKE_QUEUE_BACKEND=filesystem.');
+      throw new Error('Postgres intake queue requires a configured DATABASE_URL (or sql client). Run `construct setup` or set CONSTRUCT_INTAKE_QUEUE_BACKEND=filesystem.');
     }
     const project = opts.project ?? resolveProject(rootDir, env);
     const tenantId = opts.tenantId ?? env?.[INTAKE_TENANT_ENV_KEY] ?? null;

package/lib/project-profile.mjs

@@ -8,7 +8,7 @@
  *
  * The profile is written to `<cwd>/.cx/project-profile.json` and consumed by:
  *   - `construct skills scope` — reports relevant vs irrelevant skills
- *   - `construct init` — runs detection on bootstrap
+ *   - `construct setup` — runs detection on bootstrap
  *   - future per-host filter generators (.claude/settings.json filter,
  *     .opencode/construct-skills.json sidecars, etc.)
  */

package/lib/server/insights.mjs

@@ -42,7 +42,7 @@ async function fetchTelemetrySummary(env, { limit = 100 } = {}) {
       });
       clearTimeout(timer);
       if (res.status === 401 || res.status === 403) {
-        return { state: 'misconfigured', message: `Telemetry credentials rejected (HTTP ${res.status}). Run construct init.` };
+        return { state: 'misconfigured', message: `Telemetry credentials rejected (HTTP ${res.status}). Run construct setup.` };
       }
       if (!res.ok) return { state: 'unreachable', message: `Telemetry HTTP ${res.status}` };
       const json = await res.json();

package/lib/service-manager.mjs

@@ -379,7 +379,7 @@ function startConstructPostgres({ rootDir, homeDir = os.homedir(), spawnSyncFn =
   if (!composeRunner) return { status: 'unavailable', note: 'Docker not available' };
 
   const composeFile = constructPgComposePath(rootDir);
-  if (!fs.existsSync(composeFile)) return { status: 'unavailable', note: 'Postgres compose file not found — run construct init first' };
+  if (!fs.existsSync(composeFile)) return { status: 'unavailable', note: 'Postgres compose file not found — run construct setup first' };
 
   const args = [...composeRunner.argsPrefix, '-p', 'construct-postgres', '-f', composeFile, 'up', '-d'];
   const r = spawnSyncFn(composeRunner.command, args, { stdio: 'pipe', encoding: 'utf8' });
@@ -563,7 +563,7 @@ export async function startServices({
       results.push({ name: 'Memory (cm)', url: `http://127.0.0.1:${ports.memory}`, status: 'started' });
     }
   } else {
-    results.push({ name: 'Memory (cm)', status: 'unavailable', note: 'cm not installed — run: construct init or brew install dicklesworthstone/tap/cm' });
+    results.push({ name: 'Memory (cm)', status: 'unavailable', note: 'cm not installed — run: construct setup or brew install dicklesworthstone/tap/cm' });
   }
 
   // OpenCode (optional)

package/lib/setup-prompts.mjs

@@ -1,5 +1,5 @@
 /**
- * lib/setup-prompts.mjs — yes/no consent helper for `construct init`.
+ * lib/setup-prompts.mjs — yes/no consent helper for `construct setup`.
  *
  * Centralises the "should we install this service?" decision so Postgres,
  * telemetry, and any future service share the same prompt + consent-caching
@@ -14,7 +14,7 @@
  *   5. interactive        → prompt [Y/n], cache the answer
  *
  * Consent is stored as BOOTSTRAP_<NAME>=yes|no in ~/.construct/config.env
- * so subsequent runs of `construct init` don't re-prompt for the same
+ * so subsequent runs of `construct setup` don't re-prompt for the same
  * services. Pass `force = true` to skip the cache and re-prompt.
  */
 

package/lib/setup.mjs

@@ -4,7 +4,7 @@
  *
  * Guides users through provider selection, API key entry, and model tier
  * assignment. Writes the resulting config to ~/.cx/env and optionally to
- * project-level .env. Invoked by `construct init` and on first init.
+ * project-level .env. Invoked by `construct setup` and on first init.
  */
 
 import fs from 'node:fs';
@@ -43,7 +43,7 @@ function printHelp() {
   console.log(`Construct setup
 
 Usage:
-  construct init [--yes] [--no-docker]
+  construct setup [--yes] [--no-docker]
 
 What it does:
   - creates ~/.construct/config.env
@@ -705,7 +705,7 @@ export async function runSetup({ rootDir = ROOT_DIR, args = [], homeDir = HOME }
     console.log(`  Trace backend: ${managedValues.CONSTRUCT_TRACE_BACKEND}${managedValues.CONSTRUCT_TELEMETRY_URL ? ` (${managedValues.CONSTRUCT_TELEMETRY_URL})` : ''}`);
     console.log(`  Pressure guard: swap ${managedValues.CONSTRUCT_PRESSURE_GUARD_SWAP_GB} GiB, opencode max ${managedValues.CONSTRUCT_PRESSURE_GUARD_MAX_OPENCODE}`);
     console.log('\nFor unattended setup, including local Postgres when Docker is running:');
-    console.log('  construct init --yes');
+    console.log('  construct setup --yes');
   }
 
   runConstruct(['sync']);

package/lib/status.mjs

@@ -330,7 +330,7 @@ async function fetchTelemetryStatus(env, { timeout = 2500 } = {}) {
   try {
     const res = await fetch(`${baseUrl}/api/public/traces?limit=25`, { headers, signal: controller.signal });
     if (res.status === 401 || res.status === 403) {
-      return { status: 'credentials-invalid', summary: `Telemetry credentials rejected (HTTP ${res.status}) — run: construct init` };
+      return { status: 'credentials-invalid', summary: `Telemetry credentials rejected (HTTP ${res.status}) — run: construct setup` };
     }
     if (!res.ok) return { status: 'degraded', summary: `Telemetry HTTP ${res.status}` };
     const json = await res.json().catch(() => ({}));

package/lib/storage/postgres-backup.mjs

@@ -4,7 +4,7 @@
  *
  * Mirrors the telemetry backup pattern in service-manager.mjs. Entry points:
  *   - construct down  → stashConstructDb  (dump before container stop)
- *   - construct init → restoreConstructDb (reload after fresh container start)
+ *   - construct setup → restoreConstructDb (reload after fresh container start)
  *
  * Dumps are stored in ~/.construct/backups/postgres/ as pg_dump custom-format
  * files. The N most recent are kept; older ones are pruned automatically.

package/lib/uninstall/uninstall.mjs

@@ -312,7 +312,7 @@ function printFollowups() {
   console.log('Follow-ups (run by hand if you want):');
   console.log('  npm uninstall @geraldmaron/construct      # drop the package itself');
   console.log('  docker rmi pgvector/pgvector:pg16          # remove the cached pgvector image');
-  console.log('  brew uninstall cm cass                     # if installed by `construct init`');
+  console.log('  brew uninstall cm cass                     # if installed by `construct setup`');
 }
 
 function rel(base, target) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geraldmaron/construct",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "type": "module",
   "description": "Construct — agent orchestration layer for OpenCode, Claude Code, and other coding surfaces",
   "bin": {

package/templates/docs/construct_guide.md

@@ -80,7 +80,7 @@ construct doctor             # verify everything's healthy
 
 ## Local services
 
-If you ran `construct init` and have Docker, you have three things running locally on Construct's reserved port block (`54329-54339`, chosen to avoid colliding with Next.js, Postgres, Redis, etc.):
+If you ran `construct setup` and have Docker, you have three things running locally on Construct's reserved port block (`54329-54339`, chosen to avoid colliding with Next.js, Postgres, Redis, etc.):
 
 **Telemetry backend** (LLM observability — see your traces, costs, and quality scores)
 
@@ -105,7 +105,7 @@ All ports bind to `127.0.0.1` only; nothing is reachable from other machines on
 
 | Command | What it does |
 |---|---|
-| `construct init` | One-time per-machine: spins up local services, writes config |
+| `construct setup` | One-time per-machine: spins up local services, writes config |
 | `construct config [mode <m>]` | Show active deployment mode (solo / team / enterprise) or set a new one |
 | `construct doctor` | Health check across config, services, agents, hooks |
 | `construct sync` | Regenerate platform adapters (Claude Code, OpenCode, Codex, Cursor) |

package/templates/homebrew/construct.rb

@@ -49,7 +49,7 @@ class Construct < Formula
   def caveats
     <<~EOS
       To finish setup on this machine, run:
-        construct init
+        construct setup
 
       Construct uses a local Postgres container (via Docker) for hybrid
       retrieval. If Docker is not installed, Construct falls back to a JSON