@toolbaux/guardian 0.1.2 → 0.1.3

package/dist/cli.js

@@ -18,6 +18,7 @@ import { runDocGenerate } from "./commands/doc-generate.js";
 import { runDiscrepancy } from "./commands/discrepancy.js";
 import { runDocHtml } from "./commands/doc-html.js";
 import { runInit } from "./commands/init.js";
+import { DEFAULT_SPECS_DIR } from "./config.js";
 const program = new Command();
 program
     .name("guardian")
@@ -30,7 +31,7 @@ program
     .option("--backend-root <path>", "Path to backend root")
     .option("--frontend-root <path>", "Path to frontend root")
     .option("--config <path>", "Path to specguard.config.json")
-    .option("--output <path>", "Output directory", "specs-out")
+    .option("--output <path>", "Output directory", DEFAULT_SPECS_DIR)
     .option("--focus <text>", "Focus the generated AI context on a feature area")
     .option("--max-lines <count>", "Maximum lines for the generated context")
     .option("--ai-context", "Generate architecture-context.md for AI tools", false)
@@ -52,7 +53,7 @@ program
     .argument("[projectRoot]", "Repo or project root", process.cwd())
     .option("--backend-root <path>", "Path to backend root")
     .option("--frontend-root <path>", "Path to frontend root")
-    .option("--output <path>", "Output directory", "specs-out")
+    .option("--output <path>", "Output directory", DEFAULT_SPECS_DIR)
     .option("--include-file-graph", "Include file-level dependency graph", false)
     .option("--config <path>", "Path to specguard.config.json")
     .option("--docs-mode <mode>", "Docs mode (lean|full)")
@@ -61,7 +62,7 @@ program
         projectRoot,
         backendRoot: options.backendRoot,
         frontendRoot: options.frontendRoot,
-        output: options.output ?? "specs-out",
+        output: options.output ?? DEFAULT_SPECS_DIR,
         includeFileGraph: options.includeFileGraph ?? false,
         configPath: options.config,
         docsMode: options.docsMode
@@ -194,24 +195,24 @@ program
 program
     .command("summary")
     .description("Generate a plain-language project summary from existing snapshots")
-    .option("--input <path>", "Snapshot output directory", "specs-out")
+    .option("--input <path>", "Snapshot output directory", DEFAULT_SPECS_DIR)
     .option("--output <path>", "Summary output path")
     .action(async (options) => {
     await runSummary({
-        input: options.input ?? "specs-out",
+        input: options.input ?? DEFAULT_SPECS_DIR,
         output: options.output
     });
 });
 program
     .command("search")
     .description("Search existing snapshots for models, endpoints, components, modules, and tasks")
-    .option("--input <path>", "Snapshot output directory", "specs-out")
+    .option("--input <path>", "Snapshot output directory", DEFAULT_SPECS_DIR)
     .requiredOption("--query <text>", "Search query")
     .option("--output <path>", "Write search results to a file")
     .option("--types <items>", "Comma-separated filters: models,endpoints,components,modules,tasks")
     .action(async (options) => {
     await runSearch({
-        input: options.input ?? "specs-out",
+        input: options.input ?? DEFAULT_SPECS_DIR,
         query: options.query,
         output: options.output,
         types: options.types ? [options.types] : undefined
@@ -220,13 +221,13 @@ program
 program
     .command("context")
     .description("Render an AI-ready context block from existing snapshots")
-    .option("--input <path>", "Snapshot output directory", "specs-out")
+    .option("--input <path>", "Snapshot output directory", DEFAULT_SPECS_DIR)
     .option("--output <path>", "Append the context block to a file")
     .option("--focus <text>", "Focus the context on a feature area")
     .option("--max-lines <count>", "Maximum number of lines to include")
     .action(async (options) => {
     await runContext({
-        input: options.input ?? "specs-out",
+        input: options.input ?? DEFAULT_SPECS_DIR,
         output: options.output,
         focus: options.focus,
         maxLines: options.maxLines
@@ -258,7 +259,7 @@ program
 program
     .command("intel")
     .description("Build codebase-intelligence.json from existing snapshots")
-    .option("--specs <dir>", "Snapshot output directory", "specs-out")
+    .option("--specs <dir>", "Snapshot output directory", DEFAULT_SPECS_DIR)
     .option("--output <path>", "Output path for codebase-intelligence.json")
     .action(async (options) => {
     await runIntel({
@@ -270,7 +271,7 @@ program
     .command("feature-context")
     .description("Generate a filtered context packet for implementing a single feature")
     .requiredOption("--spec <file>", "Path to feature spec YAML")
-    .option("--specs <dir>", "Snapshot output directory", "specs-out")
+    .option("--specs <dir>", "Snapshot output directory", DEFAULT_SPECS_DIR)
     .option("--output <path>", "Output path for feature context JSON")
     .action(async (options) => {
     await runFeatureContext({
@@ -282,7 +283,7 @@ program
 program
     .command("doc-generate")
     .description("Generate a human-readable product document from codebase intelligence")
-    .option("--specs <dir>", "Snapshot output directory", "specs-out")
+    .option("--specs <dir>", "Snapshot output directory", DEFAULT_SPECS_DIR)
     .option("--feature-specs <dir>", "Directory of feature spec YAML files")
     .option("--output <path>", "Output path for product-document.md")
     .option("--update-baseline", "Freeze current state as new baseline for discrepancy tracking", false)
@@ -297,7 +298,7 @@ program
 program
     .command("discrepancy")
     .description("Diff current codebase intelligence against a committed baseline")
-    .option("--specs <dir>", "Snapshot output directory", "specs-out")
+    .option("--specs <dir>", "Snapshot output directory", DEFAULT_SPECS_DIR)
     .option("--feature-specs <dir>", "Directory of feature spec YAML files")
     .option("--output <path>", "Output path (used when --format is json or md)")
     .option("--format <fmt>", "Output format: json, md, or both (default: both)", "both")
@@ -312,11 +313,11 @@ program
 program
     .command("doc-html")
     .description("Generate a self-contained Javadoc-style HTML viewer from codebase intelligence")
-    .option("--specs <dir>", "Snapshot output directory", "specs-out")
+    .option("--specs <dir>", "Snapshot output directory", DEFAULT_SPECS_DIR)
     .option("--output <path>", "Output path for index.html")
     .action(async (options) => {
     await runDocHtml({
-        specs: options.specs ?? "specs-out",
+        specs: options.specs ?? DEFAULT_SPECS_DIR,
         output: options.output,
     });
 });
@@ -326,7 +327,7 @@ program
     .argument("[projectRoot]", "Repo or project root", process.cwd())
     .option("--backend-root <path>", "Path to backend root")
     .option("--frontend-root <path>", "Path to frontend root")
-    .option("--output <path>", "Output directory", ".specs")
+    .option("--output <path>", "Output directory", DEFAULT_SPECS_DIR)
     .option("--skip-hook", "Skip pre-commit hook installation", false)
     .action(async (projectRoot, options) => {
     await runInit({

package/dist/commands/analyze-depth.js

@@ -3,12 +3,13 @@ import fs from "node:fs/promises";
 import yaml from "js-yaml";
 import { buildSnapshots } from "../extract/index.js";
 import { analyzeDepth } from "../extract/analyzers/depth.js";
+import { DEFAULT_SPECS_DIR } from "../config.js";
 export async function runAnalyzeDepth(options) {
     const { architecture } = await buildSnapshots({
         projectRoot: options.projectRoot,
         backendRoot: options.backendRoot,
         frontendRoot: options.frontendRoot,
-        output: options.output ?? "specs-out",
+        output: options.output ?? DEFAULT_SPECS_DIR,
         includeFileGraph: true,
         configPath: options.configPath
     });

package/dist/commands/context.js

@@ -4,8 +4,9 @@ import yaml from "js-yaml";
 import { loadArchitectureDiff, loadHeatmap } from "../extract/compress.js";
 import { renderContextBlock } from "../extract/context-block.js";
 import { resolveMachineInputDir } from "../output-layout.js";
+import { DEFAULT_SPECS_DIR } from "../config.js";
 export async function runContext(options) {
-    const inputDir = await resolveMachineInputDir(options.input || "specs-out");
+    const inputDir = await resolveMachineInputDir(options.input || DEFAULT_SPECS_DIR);
     const { architecture, ux } = await loadSnapshots(inputDir);
     const [diff, heatmap] = await Promise.all([
         loadArchitectureDiff(inputDir),

package/dist/commands/extract.js

@@ -1,6 +1,9 @@
+import fs from "node:fs/promises";
 import path from "node:path";
 import { extractProject } from "../extract/index.js";
 import { runIntel } from "./intel.js";
+import { runGenerate } from "./generate.js";
+import { runContext } from "./context.js";
 export async function runExtract(options) {
     const { architecturePath, uxPath } = await extractProject(options);
     console.log(`Wrote ${architecturePath}`);
@@ -13,4 +16,26 @@ export async function runExtract(options) {
     catch {
         // Non-fatal — intel build failure should not break extract
     }
+    // Auto-generate AI context + inject into CLAUDE.md
+    const projectRoot = path.resolve(options.projectRoot || process.cwd());
+    try {
+        await runGenerate({
+            projectRoot,
+            backendRoot: options.backendRoot,
+            frontendRoot: options.frontendRoot,
+            output: specsDir,
+            aiContext: true,
+        });
+        const claudeMdPath = path.join(projectRoot, "CLAUDE.md");
+        try {
+            await fs.stat(claudeMdPath);
+            await runContext({ input: specsDir, output: claudeMdPath });
+        }
+        catch {
+            // No CLAUDE.md — skip context injection
+        }
+    }
+    catch {
+        // Non-fatal — context generation failure should not break extract
+    }
 }

package/dist/commands/generate.js

@@ -3,12 +3,13 @@ import path from "node:path";
 import { buildSnapshots } from "../extract/index.js";
 import { renderContextBlock } from "../extract/context-block.js";
 import { getOutputLayout } from "../output-layout.js";
+import { DEFAULT_SPECS_DIR } from "../config.js";
 import { analyzeDepth } from "../extract/analyzers/depth.js";
 export async function runGenerate(options) {
     if (!options.aiContext) {
         throw new Error("`specguard generate` currently supports `--ai-context` only.");
     }
-    const outputRoot = path.resolve(options.output ?? "specs-out");
+    const outputRoot = path.resolve(options.output ?? DEFAULT_SPECS_DIR);
     const layout = getOutputLayout(outputRoot);
     const { architecture, ux } = await buildSnapshots({
         projectRoot: options.projectRoot,

package/dist/commands/guard.js

@@ -6,6 +6,7 @@ import { runSimulate } from "./simulate.js";
 import { buildSnapshots } from "../extract/index.js";
 import { renderContextBlock } from "../extract/context-block.js";
 import { logResolvedProjectPaths, resolveProjectPaths } from "../project-discovery.js";
+import { DEFAULT_SPECS_DIR } from "../config.js";
 export async function runGuard(options) {
     const resolved = await resolveProjectPaths({
         projectRoot: options.projectRoot,
@@ -30,7 +31,7 @@ export async function runGuard(options) {
             projectRoot: resolved.workspaceRoot,
             backendRoot: resolved.backendRoot,
             frontendRoot: resolved.frontendRoot,
-            output: "specs-out",
+            output: DEFAULT_SPECS_DIR,
             includeFileGraph: true,
             configPath: options.configPath
         });

package/dist/commands/init.js

@@ -12,6 +12,7 @@
  */
 import fs from "node:fs/promises";
 import path from "node:path";
+import { DEFAULT_SPECS_DIR } from "../config.js";
 const DEFAULT_CONFIG = {
     project: {
         backendRoot: "./backend",
@@ -47,7 +48,7 @@ exit 0
 `;
 export async function runInit(options) {
     const root = path.resolve(options.projectRoot || process.cwd());
-    const specsDir = path.join(root, options.output || ".specs");
+    const specsDir = path.join(root, options.output || DEFAULT_SPECS_DIR);
     console.log(`Initializing Guardian in ${root}\n`);
     // 1. Create .specs/ directory
     await fs.mkdir(path.join(specsDir, "machine", "docs"), { recursive: true });

package/dist/commands/search.js

@@ -3,8 +3,9 @@ import path from "node:path";
 import yaml from "js-yaml";
 import { loadHeatmap } from "../extract/compress.js";
 import { resolveMachineInputDir } from "../output-layout.js";
+import { DEFAULT_SPECS_DIR } from "../config.js";
 export async function runSearch(options) {
-    const inputDir = await resolveMachineInputDir(options.input || "specs-out");
+    const inputDir = await resolveMachineInputDir(options.input || DEFAULT_SPECS_DIR);
     const { architecture, ux } = await loadSnapshots(inputDir);
     const heatmap = await loadHeatmap(inputDir);
     const types = normalizeTypes(options.types);

package/dist/commands/simulate.js

@@ -6,6 +6,7 @@ import { spawn } from "node:child_process";
 import yaml from "js-yaml";
 import { buildSnapshots } from "../extract/index.js";
 import { buildArchitectureSummary, loadArchitectureSummary } from "../extract/compress.js";
+import { DEFAULT_SPECS_DIR } from "../config.js";
 import { createIgnoreMatcher } from "../extract/ignore.js";
 import { logResolvedProjectPaths, resolveProjectPaths } from "../project-discovery.js";
 export async function runSimulate(options) {
@@ -106,7 +107,7 @@ async function resolveBaselineSummaryPath(params) {
     if (params.override) {
         candidates.push(params.override);
     }
-    candidates.push(path.join(params.projectRoot, "specs-out", "machine", "architecture.summary.json"));
+    candidates.push(path.join(params.projectRoot, DEFAULT_SPECS_DIR, "machine", "architecture.summary.json"));
     for (const candidate of candidates) {
         const resolved = path.isAbsolute(candidate)
             ? candidate

package/dist/commands/summary.js

@@ -4,8 +4,9 @@ import yaml from "js-yaml";
 import { renderExecutiveSummary } from "../extract/docs.js";
 import { loadArchitectureSummary, loadArchitectureDiff, loadHeatmap } from "../extract/compress.js";
 import { resolveMachineInputDir } from "../output-layout.js";
+import { DEFAULT_SPECS_DIR } from "../config.js";
 export async function runSummary(options) {
-    const inputDir = await resolveMachineInputDir(options.input || "specs-out");
+    const inputDir = await resolveMachineInputDir(options.input || DEFAULT_SPECS_DIR);
     const architecturePath = path.join(inputDir, "architecture.snapshot.yaml");
     const uxPath = path.join(inputDir, "ux.snapshot.yaml");
     const [architectureRaw, uxRaw] = await Promise.all([

package/dist/config.js

@@ -1,5 +1,7 @@
 import fs from "node:fs/promises";
 import path from "node:path";
+/** Single source of truth for the default specs output directory */
+export const DEFAULT_SPECS_DIR = ".specs";
 const DEFAULT_CONFIG = {
     project: {
         root: "",
@@ -29,8 +31,13 @@ const DEFAULT_CONFIG = {
             "log",
             "tmp",
             "cache",
-            "specs-out",
-            "ghost-out"
+            ".specs",
+            "ghost-out",
+            "ios",
+            "android",
+            ".expo",
+            ".turbo",
+            "web-build"
         ],
         paths: []
     },
@@ -77,6 +84,9 @@ const DEFAULT_CONFIG = {
         timeoutMs: 120000,
         promptTemplate: ""
     },
+    output: {
+        specsDir: DEFAULT_SPECS_DIR
+    },
     docs: {
         mode: "lean",
         internalDir: "internal"
@@ -338,6 +348,9 @@ function mergeConfig(base, override) {
             timeoutMs: override.llm?.timeoutMs ?? base.llm?.timeoutMs ?? 120000,
             promptTemplate: override.llm?.promptTemplate ?? base.llm?.promptTemplate ?? ""
         },
+        output: {
+            specsDir: override.output?.specsDir ?? base.output?.specsDir ?? DEFAULT_SPECS_DIR
+        },
         docs: {
             mode: override.docs?.mode ?? base.docs?.mode ?? "lean",
             internalDir: override.docs?.internalDir ?? base.docs?.internalDir ?? "internal"

package/dist/extract/cache.js

@@ -1,9 +1,10 @@
 import crypto from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
+import { DEFAULT_SPECS_DIR } from "../config.js";
 const BACKEND_CACHE_VERSION = "specguard-backend-cache-v4";
 export async function loadBackendExtractionCache(params) {
-    const cachePath = path.join(params.projectRoot, "specs-out", ".cache", "file-hashes.json");
+    const cachePath = path.join(params.projectRoot, DEFAULT_SPECS_DIR, ".cache", "file-hashes.json");
     const configHash = hashObject(params.config);
     try {
         const raw = await fs.readFile(cachePath, "utf8");

package/dist/output-layout.js

@@ -1,5 +1,6 @@
 import path from "node:path";
 import fs from "node:fs/promises";
+import { DEFAULT_SPECS_DIR } from "./config.js";
 export function getOutputLayout(outputRoot, internalDir = "internal") {
     const rootDir = path.resolve(outputRoot);
     const machineDir = path.join(rootDir, "machine");
@@ -12,7 +13,7 @@ export function getOutputLayout(outputRoot, internalDir = "internal") {
     };
 }
 export async function resolveMachineInputDir(input) {
-    const resolved = path.resolve(input || "specs-out");
+    const resolved = path.resolve(input || DEFAULT_SPECS_DIR);
     const directSnapshot = await hasMachineSnapshots(resolved);
     if (directSnapshot) {
         return resolved;

package/dist/project-discovery.js

@@ -1,6 +1,6 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import { loadSpecGuardConfig } from "./config.js";
+import { DEFAULT_SPECS_DIR, loadSpecGuardConfig } from "./config.js";
 const IGNORE_DIRS = new Set([
     ".git",
     "node_modules",
@@ -11,7 +11,7 @@ const IGNORE_DIRS = new Set([
     "__pycache__",
     ".venv",
     "venv",
-    "specs-out",
+    DEFAULT_SPECS_DIR,
     ".pytest_cache",
     ".mypy_cache",
     ".turbo"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolbaux/guardian",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "type": "module",
   "description": "Architectural intelligence for codebases. Verify that AI-generated code matches your architectural intent.",
   "keywords": [