chati-dev 4.2.1 → 4.3.0

package/src/decision/analyzer.js

@@ -8,6 +8,8 @@
 import { readFileSync, existsSync } from 'fs';
 import { join } from 'path';
 import yaml from 'js-yaml';
+import { resolveFrameworkDir } from '../utils/framework-dir.js';
+import { flattenEntitiesFromRegistry } from '../utils/flatten-entities.js';
 
 /**
  * Analyze impact of changing an entity.
@@ -38,12 +40,12 @@ export function analyzeImpact(projectDir, entityPath) {
   }
 
   // Load entity details
-  const registryPath = join(projectDir, 'chati.dev', 'entity-registry.yaml');
+  const registryPath = join(projectDir, resolveFrameworkDir(projectDir), 'entity-registry.yaml');
   const registry = existsSync(registryPath)
     ? yaml.load(readFileSync(registryPath, 'utf8'))
     : { entities: {} };
 
-  const allEntities = flattenEntities(registry);
+  const allEntities = flattenEntitiesFromRegistry(registry);
   const entityMap = new Map(allEntities.map(e => [e.path, e]));
 
   const affectedEntities = affectedPaths.map(path => {
@@ -68,7 +70,7 @@ export function analyzeImpact(projectDir, entityPath) {
  * @returns {Map<string, string[]>} Map of entityPath -> [dependentPaths]
  */
 export function buildDependencyGraph(projectDir) {
-  const registryPath = join(projectDir, 'chati.dev', 'entity-registry.yaml');
+  const registryPath = join(projectDir, resolveFrameworkDir(projectDir), 'entity-registry.yaml');
   const graph = new Map();
 
   if (!existsSync(registryPath)) {
@@ -76,7 +78,7 @@ export function buildDependencyGraph(projectDir) {
   }
 
   const registry = yaml.load(readFileSync(registryPath, 'utf8'));
-  const entities = flattenEntities(registry);
+  const entities = flattenEntitiesFromRegistry(registry);
 
   // Initialize graph with all entities
   entities.forEach(entity => {
@@ -287,29 +289,3 @@ function tokenize(text) {
     .filter(w => w.length > 2 && !stopwords.has(w));
 }
 
-/**
- * Flatten entity registry into array of entities.
- * @private
- * @param {object} registry
- * @returns {object[]}
- */
-function flattenEntities(registry) {
-  const entities = [];
-
-  if (!registry.entities) {
-    return entities;
-  }
-
-  Object.entries(registry.entities).forEach(([type, typeEntities]) => {
-    if (Array.isArray(typeEntities)) {
-      typeEntities.forEach(entity => {
-        entities.push({
-          ...entity,
-          type
-        });
-      });
-    }
-  });
-
-  return entities;
-}

package/src/decision/engine.js

@@ -12,6 +12,8 @@
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
 import { join } from 'path';
 import yaml from 'js-yaml';
+import { resolveFrameworkDir } from '../utils/framework-dir.js';
+import { flattenEntitiesFromRegistry } from '../utils/flatten-entities.js';
 
 /**
  * Analyze a request against existing entities and recommend action.
@@ -22,7 +24,7 @@ import yaml from 'js-yaml';
  * @returns {{ recommendation: 'REUSE'|'ADAPT'|'CREATE', score: number, matches: object[], reasoning: string }}
  */
 export function analyzeRequest(projectDir, request) {
-  const registryPath = join(projectDir, 'chati.dev', 'entity-registry.yaml');
+  const registryPath = join(projectDir, resolveFrameworkDir(projectDir), 'entity-registry.yaml');
 
   if (!existsSync(registryPath)) {
     return {
@@ -34,7 +36,7 @@ export function analyzeRequest(projectDir, request) {
   }
 
   const registry = yaml.load(readFileSync(registryPath, 'utf8'));
-  const entities = flattenEntities(registry);
+  const entities = flattenEntitiesFromRegistry(registry);
 
   // Calculate similarity scores for all entities
   const scoredMatches = entities
@@ -246,29 +248,3 @@ export function getEngineStats(projectDir) {
   return stats;
 }
 
-/**
- * Flatten entity registry into array of entities.
- * @private
- * @param {object} registry
- * @returns {object[]}
- */
-function flattenEntities(registry) {
-  const entities = [];
-
-  if (!registry.entities) {
-    return entities;
-  }
-
-  Object.entries(registry.entities).forEach(([type, typeEntities]) => {
-    if (Array.isArray(typeEntities)) {
-      typeEntities.forEach(entity => {
-        entities.push({
-          ...entity,
-          type
-        });
-      });
-    }
-  });
-
-  return entities;
-}

package/src/decision/registry-healer.js

@@ -8,6 +8,7 @@
 import { readFileSync, writeFileSync, existsSync, statSync, copyFileSync, mkdirSync } from 'fs';
 import { join, isAbsolute } from 'path';
 import yaml from 'js-yaml';
+import { resolveFrameworkDir } from '../utils/framework-dir.js';
 import { detectNewEntities, detectRemovedEntities, generateEntityMeta } from './registry-updater.js';
 
 /**
@@ -16,7 +17,7 @@ import { detectNewEntities, detectRemovedEntities, generateEntityMeta } from './
  * @returns {{ registry: object|null, registryPath: string }}
  */
 function loadRegistry(projectDir) {
-  const registryPath = join(projectDir, 'chati.dev', 'entity-registry.yaml');
+  const registryPath = join(projectDir, resolveFrameworkDir(projectDir), 'entity-registry.yaml');
   if (!existsSync(registryPath)) {
     return { registry: null, registryPath };
   }
@@ -347,7 +348,7 @@ export function detectCountMismatch(projectDir, preloaded) {
  * @returns {{ applied: number, backup: string }}
  */
 export function applyFixes(projectDir, fixes) {
-  const registryPath = join(projectDir, 'chati.dev', 'entity-registry.yaml');
+  const registryPath = join(projectDir, resolveFrameworkDir(projectDir), 'entity-registry.yaml');
 
   if (!existsSync(registryPath)) {
     return { applied: 0, backup: null };

package/src/decision/registry-updater.js

@@ -8,17 +8,26 @@
 import { readFileSync, writeFileSync, existsSync, readdirSync, statSync } from 'fs';
 import { join, basename, relative } from 'path';
 import yaml from 'js-yaml';
+import { resolveFrameworkDir } from '../utils/framework-dir.js';
 
-// Known directories to scan
-const KNOWN_DIRS = [
-  { path: 'chati.dev/agents', type: 'agent' },
-  { path: 'chati.dev/tasks', type: 'task' },
-  { path: 'chati.dev/schemas', type: 'schema' },
-  { path: 'chati.dev/domains', type: 'domain' },
-  { path: 'chati.dev/hooks', type: 'hook' },
-  { path: 'chati.dev/workflows', type: 'workflow' },
-  { path: 'chati.dev/templates', type: 'template' }
-];
+/**
+ * Build KNOWN_DIRS using resolveFrameworkDir so paths are correct
+ * for both chati.dev/ and .chati.dev/ installations.
+ * @param {string} projectDir
+ * @returns {{ path: string, type: string }[]}
+ */
+function buildKnownDirs(projectDir) {
+  const fw = resolveFrameworkDir(projectDir);
+  return [
+    { path: `${fw}/agents`, type: 'agent' },
+    { path: `${fw}/tasks`, type: 'task' },
+    { path: `${fw}/schemas`, type: 'schema' },
+    { path: `${fw}/domains`, type: 'domain' },
+    { path: `${fw}/hooks`, type: 'hook' },
+    { path: `${fw}/workflows`, type: 'workflow' },
+    { path: `${fw}/templates`, type: 'template' },
+  ];
+}
 
 /**
  * Scan project for new/changed files and update registry.
@@ -28,7 +37,7 @@ const KNOWN_DIRS = [
  */
 export function updateRegistry(projectDir, options = {}) {
   const { dryRun = false } = options;
-  const registryPath = join(projectDir, 'chati.dev', 'entity-registry.yaml');
+  const registryPath = join(projectDir, resolveFrameworkDir(projectDir), 'entity-registry.yaml');
 
   let registry = {
     metadata: {
@@ -157,7 +166,7 @@ export function updateRegistry(projectDir, options = {}) {
  * @returns {object[]} New entity candidates
  */
 export function detectNewEntities(projectDir) {
-  const registryPath = join(projectDir, 'chati.dev', 'entity-registry.yaml');
+  const registryPath = join(projectDir, resolveFrameworkDir(projectDir), 'entity-registry.yaml');
   const existingPaths = new Set();
 
   if (existsSync(registryPath)) {
@@ -175,7 +184,7 @@ export function detectNewEntities(projectDir) {
 
   const newEntities = [];
 
-  KNOWN_DIRS.forEach(({ path: dirPath, type }) => {
+  buildKnownDirs(projectDir).forEach(({ path: dirPath, type }) => {
     const fullPath = join(projectDir, dirPath);
     if (!existsSync(fullPath)) {
       return;
@@ -204,7 +213,7 @@ export function detectNewEntities(projectDir) {
  * @returns {object[]} Removed entity candidates
  */
 export function detectRemovedEntities(projectDir) {
-  const registryPath = join(projectDir, 'chati.dev', 'entity-registry.yaml');
+  const registryPath = join(projectDir, resolveFrameworkDir(projectDir), 'entity-registry.yaml');
   if (!existsSync(registryPath)) {
     return [];
   }

package/src/extensions/loader.js

@@ -11,13 +11,7 @@
 import { existsSync, readdirSync } from 'fs';
 import { join, extname, basename } from 'path';
 import { registerExtension, EXTENSION_POINTS } from './registry.js';
-
-// ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-
-/** Directory relative to project root where extensions are stored. */
-const EXTENSIONS_DIR = 'chati.dev/extensions';
+import { resolveFrameworkDir } from '../utils/framework-dir.js';
 
 /** Required fields in an extension module's default export. */
 const REQUIRED_FIELDS = ['name', 'point', 'handler'];
@@ -79,7 +73,7 @@ export function discoverExtensions(projectDir) {
     return { files: [], dir: '' };
   }
 
-  const extDir = join(projectDir, EXTENSIONS_DIR);
+  const extDir = join(projectDir, resolveFrameworkDir(projectDir), 'extensions');
 
   if (!existsSync(extDir)) {
     return { files: [], dir: extDir };

package/src/gates/g1-planning-complete.js

@@ -7,6 +7,7 @@
 
 import { existsSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
+import { resolveFrameworkDir } from '../utils/framework-dir.js';
 import { GateBase } from './gate-base.js';
 import { loadSession } from '../orchestrator/session-manager.js';
 import { loadHandoff } from '../tasks/handoff.js';
@@ -37,7 +38,7 @@ export class PlanningCompleteGate extends GateBase {
    * @returns {object} Evidence about artifact presence, session state, and handoff
    */
   _collectEvidence(projectDir) {
-    const artifactsBase = join(projectDir, 'chati.dev', 'artifacts');
+    const artifactsBase = join(projectDir, resolveFrameworkDir(projectDir), 'artifacts');
     const evidence = {
       artifacts: {},
       sessionState: null,

package/src/gates/g2-qa-planning.js

@@ -7,6 +7,7 @@
 
 import { existsSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
+import { resolveFrameworkDir } from '../utils/framework-dir.js';
 import { GateBase, determineVerdict } from './gate-base.js';
 import { loadSession } from '../orchestrator/session-manager.js';
 import { loadHandoff } from '../tasks/handoff.js';
@@ -28,7 +29,7 @@ export class QAPlanningGate extends GateBase {
    * @returns {object} Evidence about test strategy, coverage plan, risk assessment
    */
   _collectEvidence(projectDir) {
-    const artifactsBase = join(projectDir, 'chati.dev', 'artifacts');
+    const artifactsBase = join(projectDir, resolveFrameworkDir(projectDir), 'artifacts');
     const evidence = {
       testStrategy: false,
       coveragePlan: false,

package/src/gates/g3-implementation.js

@@ -8,6 +8,7 @@
 
 import { existsSync, readdirSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
+import { resolveFrameworkDir } from '../utils/framework-dir.js';
 import { GateBase } from './gate-base.js';
 import { loadSession } from '../orchestrator/session-manager.js';
 import { loadHandoff } from '../tasks/handoff.js';
@@ -97,7 +98,7 @@ export class ImplementationGate extends GateBase {
     // Check for security scan results
     const securityPaths = [
       join(projectDir, '.security-scan'),
-      join(projectDir, 'chati.dev', 'artifacts', 'security-report.md'),
+      join(projectDir, resolveFrameworkDir(projectDir), 'artifacts', 'security-report.md'),
     ];
     for (const secPath of securityPaths) {
       if (existsSync(secPath)) {

package/src/gates/g4-qa-implementation.js

@@ -14,6 +14,7 @@
 
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
+import { resolveFrameworkDir } from '../utils/framework-dir.js';
 import { GateBase, determineVerdict } from './gate-base.js';
 import { loadSession } from '../orchestrator/session-manager.js';
 import { loadHandoff } from '../tasks/handoff.js';
@@ -71,7 +72,7 @@ export class QAImplementationGate extends GateBase {
 
     // Check for performance benchmark results — parse content for real findings
     const perfPaths = [
-      join(projectDir, 'chati.dev', 'artifacts', 'performance-report.md'),
+      join(projectDir, resolveFrameworkDir(projectDir), 'artifacts', 'performance-report.md'),
       join(projectDir, '.performance-benchmark'),
     ];
     for (const perfPath of perfPaths) {
@@ -96,7 +97,7 @@ export class QAImplementationGate extends GateBase {
 
     // Check for security scan — parse content for real findings
     const secPaths = [
-      join(projectDir, 'chati.dev', 'artifacts', 'security-report.md'),
+      join(projectDir, resolveFrameworkDir(projectDir), 'artifacts', 'security-report.md'),
       join(projectDir, '.security-scan'),
     ];
     for (const secPath of secPaths) {

package/src/gates/g5-deploy-ready.js

@@ -11,6 +11,7 @@ import { join } from 'node:path';
 import { GateBase } from './gate-base.js';
 import { loadSession } from '../orchestrator/session-manager.js';
 import { loadHandoff } from '../tasks/handoff.js';
+import { resolveFrameworkDir } from '../utils/framework-dir.js';
 
 export class DeployReadyGate extends GateBase {
   constructor() {
@@ -75,7 +76,7 @@ export class DeployReadyGate extends GateBase {
     // Check release notes
     const releaseNotePaths = [
       join(projectDir, 'RELEASE.md'),
-      join(projectDir, 'chati.dev', 'artifacts', 'release-notes.md'),
+      join(projectDir, resolveFrameworkDir(projectDir), 'artifacts', 'release-notes.md'),
     ];
     for (const rnPath of releaseNotePaths) {
       if (existsSync(rnPath)) {

package/src/health/engine.js

@@ -9,6 +9,7 @@
 import { existsSync, readFileSync } from 'fs';
 import { join } from 'path';
 import { isCommandAvailable, parseProviderConfig } from '../utils/config-parser.js';
+import { resolveFrameworkDir } from '../utils/framework-dir.js';
 
 // ---------------------------------------------------------------------------
 // Check Result Types
@@ -45,7 +46,7 @@ import { isCommandAvailable, parseProviderConfig } from '../utils/config-parser.
  */
 export async function checkCliAvailability(projectDir) {
   const start = Date.now();
-  const configPath = join(projectDir, 'chati.dev', 'config.yaml');
+  const configPath = join(projectDir, resolveFrameworkDir(projectDir), 'config.yaml');
 
   if (!existsSync(configPath)) {
     return { name: 'cli-availability', status: 'warn', message: 'No config.yaml found', duration: Date.now() - start };
@@ -76,7 +77,7 @@ export async function checkCliAvailability(projectDir) {
  */
 export async function checkFrameworkIntegrity(projectDir) {
   const start = Date.now();
-  const registryPath = join(projectDir, 'chati.dev', 'data', 'entity-registry.yaml');
+  const registryPath = join(projectDir, resolveFrameworkDir(projectDir), 'data', 'entity-registry.yaml');
 
   if (!existsSync(registryPath)) {
     return { name: 'framework-integrity', status: 'warn', message: 'No entity registry found', duration: Date.now() - start };
@@ -133,7 +134,7 @@ export async function checkSessionState(projectDir) {
  */
 export async function checkHooksHealth(projectDir) {
   const start = Date.now();
-  const hooksDir = join(projectDir, 'chati.dev', 'hooks');
+  const hooksDir = join(projectDir, resolveFrameworkDir(projectDir), 'hooks');
 
   if (!existsSync(hooksDir)) {
     return { name: 'hooks-health', status: 'fail', message: 'Hooks directory not found', duration: Date.now() - start };