@cleocode/core 2026.4.5 → 2026.4.6

package/dist/validation/protocols/specification.d.ts

@@ -1,28 +1,18 @@
 /**
- * Specification protocol validation.
+ * Specification protocol — thin wrapper delegating to the canonical pure validator.
+ *
  * @task T4537
- * @epic T4454
+ * @task T260
  */
-interface ValidationResult {
-    valid: boolean;
-    violations: Array<{
-        code: string;
-        severity: string;
-        message: string;
-    }>;
-    score: number;
-    protocol: string;
-    taskId: string;
-}
+import { type ProtocolValidationResult } from '../../orchestration/protocol-validators.js';
 /** Validate specification protocol for a task. */
 export declare function validateSpecificationTask(taskId: string, opts: {
     strict?: boolean;
     specFile?: string;
-}): Promise<ValidationResult>;
-/** Validate specification protocol from manifest file. */
+}): Promise<ProtocolValidationResult>;
+/** Validate specification protocol from a manifest file. */
 export declare function checkSpecificationManifest(manifestFile: string, opts: {
     strict?: boolean;
     specFile?: string;
-}): Promise<ValidationResult>;
-export {};
+}): Promise<ProtocolValidationResult>;
 //# sourceMappingURL=specification.d.ts.map

package/dist/validation/protocols/specification.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"specification.d.ts","sourceRoot":"","sources":["../../../src/validation/protocols/specification.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,UAAU,gBAAgB;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAWD,kDAAkD;AAClD,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,OAAO,CAAC,gBAAgB,CAAC,CA4D3B;AAED,0DAA0D;AAC1D,wBAAsB,0BAA0B,CAC9C,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,OAAO,CAAC,gBAAgB,CAAC,CAO3B"}
+{"version":3,"file":"specification.d.ts","sourceRoot":"","sources":["../../../src/validation/protocols/specification.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,KAAK,wBAAwB,EAE9B,MAAM,4CAA4C,CAAC;AAOpD,kDAAkD;AAClD,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,OAAO,CAAC,wBAAwB,CAAC,CAOnC;AAED,4DAA4D;AAC5D,wBAAsB,0BAA0B,CAC9C,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,OAAO,CAAC,wBAAwB,CAAC,CAQnC"}

package/dist/validation/protocols/testing.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Testing protocol — thin wrapper delegating to the canonical pure validator.
+ *
+ * Renamed from testing-protocol.ts in T260. The testing protocol is the
+ * project-agnostic IVT loop closure stage: it checks that a detected test
+ * framework ran, achieved 100% pass rate, and the Implement→Validate→Test
+ * loop converged on the specification. Framework detection and loop logic
+ * live in the `ct-ivt-looper` skill; this validator only certifies results.
+ *
+ * @task T4804
+ * @task T260 — drop -protocol suffix, delegate, project-agnostic IVT
+ */
+import { type ProtocolValidationResult, type TestingOptions } from '../../orchestration/protocol-validators.js';
+/** Validate testing protocol for a task. */
+export declare function validateTestingTask(taskId: string, opts: {
+    strict?: boolean;
+} & TestingOptions): Promise<ProtocolValidationResult>;
+/** Validate testing protocol from a manifest file. */
+export declare function checkTestingManifest(manifestFile: string, opts: {
+    strict?: boolean;
+} & TestingOptions): Promise<ProtocolValidationResult>;
+//# sourceMappingURL=testing.d.ts.map

package/dist/validation/protocols/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../src/validation/protocols/testing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,cAAc,EAEpB,MAAM,4CAA4C,CAAC;AAOpD,4CAA4C;AAC5C,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,cAAc,GAC1C,OAAO,CAAC,wBAAwB,CAAC,CAKnC;AAED,sDAAsD;AACtD,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,cAAc,GAC1C,OAAO,CAAC,wBAAwB,CAAC,CAMnC"}

package/dist/validation/protocols/validation.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Validation protocol — thin wrapper delegating to the canonical pure validator.
+ *
+ * Renamed from validation-protocol.ts in T260. The validation stage runs
+ * static analysis, type checking, and pre-test quality gates. It is the
+ * first half of the IVT loop (Implement → Validate → Test); the validator
+ * here only verifies that a validation run produced a proper manifest
+ * entry — runtime gate enforcement is in the lifecycle state machine.
+ *
+ * @task T4804
+ * @task T260 — drop -protocol suffix, delegate to orchestration validator
+ */
+import { type ProtocolValidationResult, type ValidationStageOptions } from '../../orchestration/protocol-validators.js';
+/** Validate validation-stage protocol for a task. */
+export declare function validateValidationTask(taskId: string, opts: {
+    strict?: boolean;
+} & ValidationStageOptions): Promise<ProtocolValidationResult>;
+/** Validate validation-stage protocol from a manifest file. */
+export declare function checkValidationManifest(manifestFile: string, opts: {
+    strict?: boolean;
+} & ValidationStageOptions): Promise<ProtocolValidationResult>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation/protocols/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/validation/protocols/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAE5B,MAAM,4CAA4C,CAAC;AAOpD,qDAAqD;AACrD,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,sBAAsB,GAClD,OAAO,CAAC,wBAAwB,CAAC,CAKnC;AAED,+DAA+D;AAC/D,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,sBAAsB,GAClD,OAAO,CAAC,wBAAwB,CAAC,CAMnC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/core",
-  "version": "2026.4.5",
+  "version": "2026.4.6",
   "description": "CLEO core business logic kernel — tasks, sessions, memory, orchestration, lifecycle, with bundled SQLite store",
   "type": "module",
   "main": "./dist/index.js",
@@ -35,12 +35,12 @@
     "write-file-atomic": "^6.0.0",
     "yaml": "^2.8.2",
     "zod": "^3.25.76",
-    "@cleocode/adapters": "2026.4.5",
-    "@cleocode/caamp": "2026.4.5",
-    "@cleocode/contracts": "2026.4.5",
-    "@cleocode/agents": "2026.4.5",
-    "@cleocode/lafs": "2026.4.5",
-    "@cleocode/skills": "2026.4.5"
+    "@cleocode/adapters": "2026.4.6",
+    "@cleocode/caamp": "2026.4.6",
+    "@cleocode/contracts": "2026.4.6",
+    "@cleocode/lafs": "2026.4.6",
+    "@cleocode/agents": "2026.4.6",
+    "@cleocode/skills": "2026.4.6"
   },
   "optionalDependencies": {
     "tree-sitter-c": "^0.24.1",

package/src/__tests__/injection-mvi-tiers.test.js

@@ -1,12 +1,12 @@
 /**
- * Test CLEO-INJECTION.md v2.3.0 minimal-only template.
+ * Test CLEO-INJECTION.md v2.4.0 optimized CLI-only template.
  *
  * Validates the trimmed template:
- * 1. Has version 2.3.0
- * 2. Contains all minimal sections
- * 3. Does NOT contain standard/orchestrator content
+ * 1. Has version 2.4.0 with CLI-only dispatch
+ * 2. Contains all essential sections (session start, work loop, discovery, memory, errors)
+ * 3. Uses `cleo` prefix exclusively (no `ct` prefix, no MCP syntax)
  * 4. Contains escalation section with skill pointers
- * 5. Does NOT contain TIER markers
+ * 5. Is under 100 lines (optimized for token efficiency)
  *
  * @task T5096
  */
@@ -15,106 +15,84 @@ import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { describe, expect, it } from 'vitest';
 const thisFile = fileURLToPath(import.meta.url);
-// Template moved to packages/core/templates/ (was at monorepo root templates/)
-// thisFile is at packages/core/src/__tests__/, go up two levels to reach packages/core/
 const corePackageRoot = resolve(dirname(thisFile), '..', '..');
 const injectionPath = join(corePackageRoot, 'templates', 'CLEO-INJECTION.md');
 const templateExists = existsSync(injectionPath);
-describe('CLEO-INJECTION v2.3.0 minimal-only template', () => {
+describe('CLEO-INJECTION v2.4.0 CLI-only template', () => {
     const content = templateExists ? readFileSync(injectionPath, 'utf-8') : '';
     it('template file exists at templates/CLEO-INJECTION.md', () => {
         expect(templateExists).toBe(true);
     });
-    describe('Version and metadata', () => {
-        it('has version 2.3.0', () => {
-            expect(content).toContain('Version: 2.3.0');
+    describe('Version and identity', () => {
+        it('has version 2.4.0', () => {
+            expect(content).toContain('Version: 2.4.0');
         });
-        it('has status ACTIVE', () => {
-            expect(content).toContain('Status: ACTIVE');
-        });
-    });
-    describe('Contains all minimal sections', () => {
-        it('includes CLEO Identity section', () => {
-            expect(content).toContain('## CLEO Identity');
-            expect(content).toContain('CLEO protocol agent');
+        it('declares CLI-only dispatch', () => {
+            expect(content).toContain('CLI-only dispatch');
             expect(content).toContain('cleo <command>');
         });
-        it('includes Mandatory Efficiency Sequence', () => {
-            expect(content).toContain('## Mandatory Efficiency Sequence');
+    });
+    describe('Contains essential sections', () => {
+        it('includes Session Start sequence', () => {
+            expect(content).toContain('## Session Start');
             expect(content).toContain('cleo session status');
             expect(content).toContain('cleo dash');
             expect(content).toContain('cleo current');
             expect(content).toContain('cleo next');
             expect(content).toContain('cleo show');
         });
-        it('includes Agent Work Loop', () => {
-            expect(content).toContain('## Agent Work Loop');
-            expect(content).toContain('cleo current');
+        it('includes Work Loop', () => {
+            expect(content).toContain('## Work Loop');
             expect(content).toContain('cleo complete');
-            expect(content).toContain('cleo next');
         });
-        it('includes Context Ethics', () => {
-            expect(content).toContain('## Context Ethics');
-            expect(content).toContain('Anti-patterns');
+        it('includes Task Discovery', () => {
+            expect(content).toContain('## Task Discovery');
+            expect(content).toContain('cleo find');
+            expect(content).toContain('cleo list');
+        });
+        it('includes Session Commands', () => {
+            expect(content).toContain('## Session Commands');
+            expect(content).toContain('cleo briefing');
+        });
+        it('includes Memory (BRAIN)', () => {
+            expect(content).toContain('## Memory (BRAIN)');
+            expect(content).toContain('cleo memory find');
+            expect(content).toContain('cleo memory timeline');
+            expect(content).toContain('cleo memory fetch');
+            expect(content).toContain('cleo observe');
         });
         it('includes Error Handling', () => {
             expect(content).toContain('## Error Handling');
             expect(content).toContain('exit code');
+            expect(content).toContain('E_NOT_FOUND');
         });
-        it('includes Task Discovery', () => {
-            expect(content).toContain('## Task Discovery');
-            expect(content).toContain('tasks find');
-        });
-        it('includes Time Estimates Prohibited', () => {
-            expect(content).toContain('## Time Estimates Prohibited');
-            expect(content).toContain('MUST NOT');
+        it('includes Rules', () => {
+            expect(content).toContain('## Rules');
+            expect(content).toContain('small');
+            expect(content).toContain('medium');
+            expect(content).toContain('large');
         });
     });
-    describe('Does NOT contain standard/orchestrator content', () => {
-        it('does not contain Session Protocol section', () => {
-            expect(content).not.toContain('## Session Protocol');
+    describe('CLI-only — no legacy MCP or ct syntax', () => {
+        it('does not use ct prefix for commands', () => {
+            expect(content).not.toMatch(/`ct /);
         });
-        it('does not contain CLI Fallback section', () => {
-            expect(content).not.toContain('## CLI Fallback');
+        it('does not contain MCP query/mutate syntax', () => {
+            expect(content).not.toContain('query({');
+            expect(content).not.toContain('mutate({');
+            expect(content).not.toContain('orchestrate.bootstrap');
         });
-        it('does not contain RCASD lifecycle', () => {
-            expect(content).not.toContain('## RCASD-IVTR+C');
-            expect(content).not.toContain('RCASD-IVTR+C Lifecycle');
+        it('does not contain TIER markers', () => {
+            expect(content).not.toMatch(/<!-- TIER:\w+ -->/);
         });
-        it('does not contain ORC constraints', () => {
+        it('does not contain removed standard/orchestrator content', () => {
+            expect(content).not.toContain('## RCASD-IVTR+C');
             expect(content).not.toContain('ORC-001');
-            expect(content).not.toContain('## ORC Constraints');
-        });
-        it('does not contain BASE constraints', () => {
-            expect(content).not.toContain('BASE-001');
-            expect(content).not.toContain('## BASE Constraints');
-        });
-        it('does not contain Spawn Pipeline section', () => {
             expect(content).not.toContain('## Spawn Pipeline');
         });
-        it('does not contain Architecture Overview section', () => {
-            expect(content).not.toContain('## Architecture Overview');
-        });
-        it('does not contain Token Pre-Resolution section', () => {
-            expect(content).not.toContain('## Token Pre-Resolution');
-        });
-        it('does not contain Subagent Lifecycle section', () => {
-            expect(content).not.toContain('## Subagent Lifecycle');
-        });
-    });
-    describe('Does NOT contain TIER markers', () => {
-        it('has no TIER opening markers', () => {
-            expect(content).not.toMatch(/<!-- TIER:\w+ -->/);
-        });
-        it('has no TIER closing markers', () => {
-            expect(content).not.toMatch(/<!-- \/TIER:\w+ -->/);
-        });
-        it('does not contain MVI Progressive Disclosure comment', () => {
-            expect(content).not.toContain('MVI Progressive Disclosure');
-        });
     });
     describe('Contains escalation section', () => {
-        it('has Escalation section header', () => {
+        it('has Escalation section', () => {
             expect(content).toContain('## Escalation');
         });
         it('points to ct-cleo skill', () => {
@@ -123,29 +101,15 @@ describe('CLEO-INJECTION v2.3.0 minimal-only template', () => {
         it('points to ct-orchestrator skill', () => {
             expect(content).toContain('ct-orchestrator');
         });
-        it('points to admin help', () => {
-            expect(content).toContain('admin help');
-        });
-        it('points to operations reference', () => {
-            expect(content).toContain('CLEO-OPERATIONS-REFERENCE.md');
-        });
-    });
-    describe('References section', () => {
-        it('has References section', () => {
-            expect(content).toContain('## References');
-        });
-        it('references VERB-STANDARDS.md', () => {
-            expect(content).toContain('VERB-STANDARDS.md');
-        });
     });
     describe('Template size', () => {
-        it('is under 160 lines', () => {
+        it('is under 100 lines (token-optimized)', () => {
             const lines = content.split('\n').length;
-            expect(lines).toBeLessThan(160);
+            expect(lines).toBeLessThanOrEqual(100);
         });
-        it('is at least 60 lines (not accidentally empty)', () => {
+        it('is at least 50 lines (not accidentally empty)', () => {
             const lines = content.split('\n').length;
-            expect(lines).toBeGreaterThan(60);
+            expect(lines).toBeGreaterThan(50);
         });
     });
 });

package/src/__tests__/injection-mvi-tiers.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"injection-mvi-tiers.test.js","sourceRoot":"","sources":["injection-mvi-tiers.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"injection-mvi-tiers.test.js","sourceRoot":"","sources":["injection-mvi-tiers.test.ts"],"names":[],"mappings":"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"}

package/src/discovery.ts

@@ -0,0 +1,235 @@
+/**
+ * Greenfield/Brownfield project discovery & classification (Phase 5).
+ *
+ * Classifies a project directory as either:
+ *   - **greenfield**: empty or nearly-empty, no code, no git history
+ *   - **brownfield**: existing codebase with files, possibly git history
+ *
+ * Used by `cleo init` (Phase 5 bootstrap) to choose the correct seed
+ * pipeline:
+ *   - Greenfield → seed a Vision/PRD "research" epic so the agent starts
+ *     from a blank-slate planning posture
+ *   - Brownfield → invoke codebase mapping and anchor findings in BRAIN as
+ *     baseline context (per ULTRAPLAN §1 "Context Anchoring")
+ *
+ * Classification is intentionally simple and transparent — no heuristics,
+ * no ML, just file/directory presence checks. A project qualifies as
+ * brownfield if ANY of these are true:
+ *   - `.git/` directory exists (under a size threshold we still treat as
+ *     brownfield since history matters)
+ *   - source files exist under common source dirs (src, lib, app, packages)
+ *   - any manifest file exists (package.json, Cargo.toml, go.mod, pyproject.toml)
+ *   - markdown docs already exist (README.md, docs/)
+ *
+ * @task Phase 5 — Greenfield/brownfield bootstrap + context anchoring
+ */
+
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+
+/**
+ * Classification result for a project directory.
+ */
+export interface ProjectClassification {
+  /** Project type: 'greenfield' (empty/new) or 'brownfield' (existing). */
+  kind: 'greenfield' | 'brownfield';
+  /** Absolute path that was classified. */
+  directory: string;
+  /** Signal list — which indicators led to the classification. */
+  signals: ClassificationSignal[];
+  /** Total non-hidden files found at the top level (for reporting). */
+  topLevelFileCount: number;
+  /** Whether a `.git/` directory is present. */
+  hasGit: boolean;
+}
+
+/** A single classification signal detected on the filesystem. */
+export interface ClassificationSignal {
+  /** Canonical signal id for programmatic handling. */
+  id:
+    | 'git-dir'
+    | 'source-dir'
+    | 'package-manifest'
+    | 'docs'
+    | 'rust-manifest'
+    | 'go-manifest'
+    | 'python-manifest'
+    | 'readme'
+    | 'empty';
+  /** Human-readable description of what was detected. */
+  description: string;
+  /** File or directory that triggered this signal. */
+  path: string;
+}
+
+// ============================================================================
+// Detection helpers
+// ============================================================================
+
+/** Common source directory names that indicate an existing codebase. */
+const SOURCE_DIRS = ['src', 'lib', 'app', 'packages', 'crates', 'cmd', 'internal'];
+
+/** Manifest files that indicate a managed project. */
+const MANIFESTS: Array<{
+  file: string;
+  signal: ClassificationSignal['id'];
+  description: string;
+}> = [
+  { file: 'package.json', signal: 'package-manifest', description: 'Node.js manifest' },
+  { file: 'Cargo.toml', signal: 'rust-manifest', description: 'Rust manifest' },
+  { file: 'go.mod', signal: 'go-manifest', description: 'Go manifest' },
+  { file: 'pyproject.toml', signal: 'python-manifest', description: 'Python manifest (PEP 621)' },
+  { file: 'requirements.txt', signal: 'python-manifest', description: 'Python requirements.txt' },
+  { file: 'setup.py', signal: 'python-manifest', description: 'Python setup.py' },
+];
+
+/** Docs files/directories that indicate prior work. */
+const DOCS_MARKERS: Array<{ path: string; signal: ClassificationSignal['id'] }> = [
+  { path: 'README.md', signal: 'readme' },
+  { path: 'README.rst', signal: 'readme' },
+  { path: 'docs', signal: 'docs' },
+];
+
+/**
+ * Check if a directory (at the top level only) contains any files that are
+ * NOT part of the CLEO scaffolding itself. Used to decide whether the caller
+ * is about to `cleo init` into an already-populated directory.
+ */
+function countMeaningfulTopLevelFiles(directory: string): number {
+  if (!existsSync(directory)) return 0;
+  try {
+    const entries = readdirSync(directory);
+    let count = 0;
+    for (const entry of entries) {
+      // Ignore hidden files, the CLEO dir itself, and common CI/git debris
+      if (
+        entry.startsWith('.') ||
+        entry === '.cleo' ||
+        entry === 'node_modules' ||
+        entry === 'target' ||
+        entry === 'dist' ||
+        entry === 'build'
+      ) {
+        continue;
+      }
+      count += 1;
+    }
+    return count;
+  } catch {
+    return 0;
+  }
+}
+
+// ============================================================================
+// Public API
+// ============================================================================
+
+/**
+ * Classify a project directory as greenfield or brownfield.
+ *
+ * Read-only — never mutates the filesystem. Safe to call at any time.
+ *
+ * @param directory - Absolute or relative path; defaults to process.cwd()
+ * @returns Classification result with signals and metadata
+ *
+ * @example
+ * ```typescript
+ * const classification = classifyProject('/my/project');
+ * if (classification.kind === 'greenfield') {
+ *   // Seed initial Vision epic
+ * } else {
+ *   // Run codebase mapping
+ * }
+ * ```
+ */
+export function classifyProject(directory?: string): ProjectClassification {
+  const root = resolve(directory ?? process.cwd());
+  const signals: ClassificationSignal[] = [];
+
+  // Signal 1: .git directory
+  const gitPath = join(root, '.git');
+  const hasGit = existsSync(gitPath);
+  if (hasGit) {
+    signals.push({
+      id: 'git-dir',
+      description: '.git/ directory present — project has version history',
+      path: gitPath,
+    });
+  }
+
+  // Signal 2: manifest files
+  for (const manifest of MANIFESTS) {
+    const manifestPath = join(root, manifest.file);
+    if (existsSync(manifestPath)) {
+      signals.push({
+        id: manifest.signal,
+        description: manifest.description,
+        path: manifestPath,
+      });
+    }
+  }
+
+  // Signal 3: common source directories
+  for (const dir of SOURCE_DIRS) {
+    const srcPath = join(root, dir);
+    if (existsSync(srcPath) && isNonEmptyDir(srcPath)) {
+      signals.push({
+        id: 'source-dir',
+        description: `Source directory ${dir}/ contains files`,
+        path: srcPath,
+      });
+      break; // One source-dir signal is enough
+    }
+  }
+
+  // Signal 4: docs / README
+  for (const marker of DOCS_MARKERS) {
+    const markerPath = join(root, marker.path);
+    if (existsSync(markerPath)) {
+      signals.push({
+        id: marker.signal,
+        description: `${marker.path} present`,
+        path: markerPath,
+      });
+      break;
+    }
+  }
+
+  const topLevelFileCount = countMeaningfulTopLevelFiles(root);
+
+  // Empty signal if we have nothing
+  if (signals.length === 0 && topLevelFileCount === 0) {
+    signals.push({
+      id: 'empty',
+      description: 'No source files, manifests, git history, or docs detected',
+      path: root,
+    });
+  }
+
+  // Classification rule: brownfield if ANY non-'empty' signal present
+  const kind: ProjectClassification['kind'] = signals.some((s) => s.id !== 'empty')
+    ? 'brownfield'
+    : 'greenfield';
+
+  return {
+    kind,
+    directory: root,
+    signals,
+    topLevelFileCount,
+    hasGit,
+  };
+}
+
+/**
+ * True if a directory exists AND contains at least one non-hidden entry.
+ */
+function isNonEmptyDir(dirPath: string): boolean {
+  try {
+    const stat = statSync(dirPath);
+    if (!stat.isDirectory()) return false;
+    const entries = readdirSync(dirPath).filter((e) => !e.startsWith('.'));
+    return entries.length > 0;
+  } catch {
+    return false;
+  }
+}

package/src/hooks/handlers/__tests__/hook-automation-e2e.test.js

@@ -64,7 +64,9 @@ const TIMESTAMP = '2026-03-24T00:00:00.000Z';
 // ---------------------------------------------------------------------------
 describe('hook automation E2E', () => {
     beforeEach(() => {
-        observeBrainMock.mockReset().mockResolvedValue({ id: 'O-test', type: 'observation', createdAt: '2026-01-01 00:00:00' });
+        observeBrainMock
+            .mockReset()
+            .mockResolvedValue({ id: 'O-test', type: 'observation', createdAt: '2026-01-01 00:00:00' });
         loadConfigMock.mockReset().mockResolvedValue(makeConfig());
         maybeRefreshMemoryBridgeMock.mockReset().mockResolvedValue(undefined);
         // Clear work-capture env var