@kynetic-ai/spec 0.1.2 → 0.4.0

package/dist/parser/config.js

@@ -0,0 +1,373 @@
+/**
+ * Project-level configuration for kspec.
+ *
+ * Loads kspec.config.yaml from the project root (main branch) before shadow
+ * branch detection. All fields are optional with backward-compatible defaults.
+ *
+ * Priority: env vars > config file > defaults
+ *
+ * @module
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { z } from "zod";
+import * as YAML from "yaml";
+import { getGitRoot } from "./shadow.js";
+// ── Schema ──────────────────────────────────────────────────────────────
+/**
+ * Schema for shadow branch configuration.
+ *
+ * AC: @config-shadow — shadow.branch, shadow.directory, shadow.remote configurable
+ */
+const ShadowConfigSchema = z
+    .object({
+    /** Branch name for shadow branch (default: kspec-meta) */
+    branch: z.string().optional(),
+    /** Worktree directory name (default: .kspec) */
+    directory: z.string().optional(),
+    /**
+     * Remote target for shadow branch. Can be:
+     * - Named remote (e.g., "origin", "specs-origin")
+     * - Local filesystem path (starts with /, ./, or ~)
+     * - Git URL (contains :// or starts with git@)
+     */
+    remote: z.string().optional(),
+})
+    .strict()
+    .optional();
+/**
+ * Schema for identity configuration.
+ */
+const IdentityConfigSchema = z
+    .object({
+    /** Default author for notes/tasks (overridden by KSPEC_AUTHOR env var) */
+    author: z.string().optional(),
+})
+    .strict()
+    .optional();
+/**
+ * Schema for validation configuration.
+ *
+ * AC: @config-validation — validation settings configurable in kspec.config.yaml
+ */
+const ValidationConfigSchema = z
+    .object({
+    /**
+     * When true, dangling references are treated as errors instead of warnings.
+     * AC: @config-validation ac-2 ac-3 — strict_refs configurable
+     */
+    strict_refs: z.boolean().optional(),
+    /**
+     * When true, specs missing acceptance criteria are reported as errors not warnings.
+     * AC: @config-validation ac-1 — require_acceptance configurable
+     */
+    require_acceptance: z.boolean().optional(),
+})
+    .strict()
+    .optional();
+/**
+ * Schema for daemon configuration.
+ *
+ * AC: @config-daemon — daemon.port, daemon.auto_start configurable
+ */
+const DaemonConfigSchema = z
+    .object({
+    /** Default port for daemon (default: 3456) */
+    port: z.number().int().min(1).max(65535).optional(),
+    /** Host to bind to (default: localhost) */
+    host: z.string().optional(),
+    /**
+     * Whether to auto-start daemon when running kspec commands.
+     * AC: @config-daemon ac-3 — auto_start configurable
+     */
+    auto_start: z.boolean().optional(),
+})
+    .strict()
+    .optional();
+/**
+ * Schema for ralph skill name overrides.
+ *
+ * Ralph prompts reference skills by invocation name. These default to
+ * kspec: namespace core skills but can be overridden per-project for
+ * projects that use project-specific skill names.
+ */
+const RalphSkillsSchema = z
+    .object({
+    /** Skill invocation for task-work (default: /kspec:task-work) */
+    task_work: z.string().optional(),
+    /** Skill invocation for reflect (default: /kspec:reflect) */
+    reflect: z.string().optional(),
+    /** Skill invocation for PR review (default: /kspec:review) */
+    pr_review: z.string().optional(),
+})
+    .strict()
+    .optional();
+/**
+ * Schema for ralph configuration.
+ */
+const RalphConfigSchema = z
+    .object({
+    /** Skill invocation name overrides */
+    skills: RalphSkillsSchema,
+})
+    .strict()
+    .optional();
+/**
+ * Complete schema for kspec.config.yaml.
+ *
+ * AC: @project-config ac-4 — unknown fields are ignored via passthrough
+ */
+export const KspecConfigSchema = z
+    .object({
+    /** Shadow branch configuration */
+    shadow: ShadowConfigSchema,
+    /** Identity configuration */
+    identity: IdentityConfigSchema,
+    /** Validation configuration */
+    validation: ValidationConfigSchema,
+    /** Daemon configuration */
+    daemon: DaemonConfigSchema,
+    /** Ralph automation configuration */
+    ralph: RalphConfigSchema,
+})
+    .passthrough(); // AC: ac-4 — ignore unknown fields
+/**
+ * Detect the type of a shadow remote string.
+ *
+ * AC: @config-shadow ac-3 ac-4 ac-5 — remote type detection
+ *
+ * @param remote Remote string from config
+ * @returns Detected type: "path" for filesystem, "url" for git URLs, "named" for git remote names
+ */
+export function detectRemoteType(remote) {
+    // AC: ac-4 — Local filesystem path (starts with /, ./, ../, or ~)
+    if (remote.startsWith("/") ||
+        remote.startsWith("./") ||
+        remote.startsWith("../") ||
+        remote.startsWith("~")) {
+        return "path";
+    }
+    // AC: ac-5 — Git URL (contains :// or starts with git@)
+    if (remote.includes("://") || remote.startsWith("git@")) {
+        return "url";
+    }
+    // AC: ac-3 — Otherwise it's a named remote
+    return "named";
+}
+// ── Defaults ────────────────────────────────────────────────────────────
+/**
+ * Default configuration values.
+ *
+ * AC: @project-config ac-1 — these are the current defaults
+ */
+const DEFAULT_CONFIG = {
+    shadow: {
+        branch: "kspec-meta",
+        directory: ".kspec",
+        remote: null,
+    },
+    identity: {
+        author: null,
+    },
+    validation: {
+        // AC: @config-validation — defaults preserve existing behavior
+        // strict_refs: true = dangling refs are errors (existing behavior)
+        // require_acceptance: false = missing AC is warning (existing behavior)
+        strict_refs: true,
+        require_acceptance: false,
+    },
+    daemon: {
+        port: 3456,
+        host: "localhost",
+        auto_start: true, // AC: @config-daemon — default auto-start enabled
+    },
+    ralph: {
+        skills: {
+            task_work: "/kspec:task-work",
+            reflect: "/kspec:reflect",
+            pr_review: "/kspec:review",
+        },
+    },
+};
+// ── Loading ─────────────────────────────────────────────────────────────
+const CONFIG_FILENAME = "kspec.config.yaml";
+/**
+ * Find git root directory, handling KSPEC_SPEC_DIR batch mode.
+ *
+ * AC: @project-config ac-7 — in batch mode, we need the REAL project root
+ *
+ * When KSPEC_SPEC_DIR is set (batch atomic mode), the cwd might be the temp
+ * directory. We need to find the real project root by checking:
+ * 1. If KSPEC_BATCH_PROJECT_ROOT is set, use that (set by batch executor)
+ * 2. Otherwise, use git root from cwd
+ *
+ * AC: @project-config ac-6 — loads from git root, not cwd subdirectory
+ */
+export function findProjectRoot(startDir) {
+    // In batch mode, the batch executor should set this to the real root
+    // before redirecting KSPEC_SPEC_DIR
+    const batchRoot = process.env.KSPEC_BATCH_PROJECT_ROOT;
+    if (batchRoot) {
+        return batchRoot;
+    }
+    // Normal mode: find git root
+    return getGitRoot(startDir);
+}
+/**
+ * Load project configuration from kspec.config.yaml.
+ *
+ * AC: @project-config ac-1 — no config = all defaults
+ * AC: @project-config ac-2 — config parsed and available before shadow detection
+ * AC: @project-config ac-3 — invalid YAML = defaults + warning
+ * AC: @project-config ac-4 — unknown fields ignored
+ * AC: @project-config ac-5 — env vars take precedence
+ * AC: @project-config ac-6 — loads from git root
+ * AC: @project-config ac-7 — batch mode uses real project root
+ *
+ * @param startDir Starting directory for git root detection
+ */
+export async function loadProjectConfig(startDir = process.cwd()) {
+    const gitRoot = findProjectRoot(startDir);
+    if (!gitRoot) {
+        // Not in a git repo, use defaults
+        return {
+            config: resolveConfig(null),
+            configPath: null,
+            warning: null,
+            gitRoot: null,
+        };
+    }
+    const configPath = path.join(gitRoot, CONFIG_FILENAME);
+    // Check if config file exists
+    try {
+        await fs.access(configPath);
+    }
+    catch {
+        // AC: ac-1 — no config file, use defaults
+        return {
+            config: resolveConfig(null),
+            configPath: null,
+            warning: null,
+            gitRoot,
+        };
+    }
+    // Try to load and parse config
+    try {
+        const content = await fs.readFile(configPath, "utf-8");
+        const raw = YAML.parse(content);
+        // Validate against schema
+        const result = KspecConfigSchema.safeParse(raw);
+        if (!result.success) {
+            // AC: ac-3 — validation error = defaults + warning
+            const issues = result.error.issues
+                .map((i) => `${i.path.join(".")}: ${i.message}`)
+                .join("; ");
+            return {
+                config: resolveConfig(null),
+                configPath,
+                warning: `Config validation failed: ${issues}. Using defaults.`,
+                gitRoot,
+            };
+        }
+        // AC: ac-5 — apply env var overrides during resolution
+        return {
+            config: resolveConfig(result.data),
+            configPath,
+            warning: null,
+            gitRoot,
+        };
+    }
+    catch (err) {
+        // AC: ac-3 — parse error = defaults + warning
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            config: resolveConfig(null),
+            configPath,
+            warning: `Failed to parse ${CONFIG_FILENAME}: ${message}. Using defaults.`,
+            gitRoot,
+        };
+    }
+}
+/**
+ * Resolve configuration by merging file config with env vars and defaults.
+ *
+ * Priority: env vars > config file > defaults
+ *
+ * AC: @project-config ac-5 — env vars take precedence
+ */
+export function resolveConfig(fileConfig) {
+    const file = fileConfig || {};
+    // Get env var overrides
+    const envAuthor = process.env.KSPEC_AUTHOR;
+    const envPort = process.env.KSPEC_DAEMON_PORT
+        ? parseInt(process.env.KSPEC_DAEMON_PORT, 10)
+        : undefined;
+    const envHost = process.env.KSPEC_DAEMON_HOST;
+    // Resolve shadow remote if specified
+    const remoteValue = file.shadow?.remote;
+    const resolvedRemote = remoteValue
+        ? { value: remoteValue, type: detectRemoteType(remoteValue) }
+        : DEFAULT_CONFIG.shadow.remote;
+    return {
+        shadow: {
+            branch: file.shadow?.branch ?? DEFAULT_CONFIG.shadow.branch,
+            directory: file.shadow?.directory ?? DEFAULT_CONFIG.shadow.directory,
+            remote: resolvedRemote,
+        },
+        identity: {
+            // AC: ac-5 — env var takes precedence
+            author: envAuthor ?? file.identity?.author ?? DEFAULT_CONFIG.identity.author,
+        },
+        validation: {
+            // AC: @config-validation ac-2 ac-3 — strict_refs from config
+            strict_refs: file.validation?.strict_refs ?? DEFAULT_CONFIG.validation.strict_refs,
+            // AC: @config-validation ac-1 — require_acceptance from config
+            require_acceptance: file.validation?.require_acceptance ?? DEFAULT_CONFIG.validation.require_acceptance,
+        },
+        daemon: {
+            // AC: ac-5 — env vars take precedence
+            port: (envPort && !isNaN(envPort) ? envPort : undefined) ??
+                file.daemon?.port ??
+                DEFAULT_CONFIG.daemon.port,
+            // AC: @config-daemon ac-5 ac-6 — host from config/env
+            host: envHost ?? file.daemon?.host ?? DEFAULT_CONFIG.daemon.host,
+            // AC: @config-daemon ac-3 — auto_start from config
+            auto_start: file.daemon?.auto_start ?? DEFAULT_CONFIG.daemon.auto_start,
+        },
+        ralph: {
+            skills: {
+                task_work: file.ralph?.skills?.task_work ?? DEFAULT_CONFIG.ralph.skills.task_work,
+                reflect: file.ralph?.skills?.reflect ?? DEFAULT_CONFIG.ralph.skills.reflect,
+                pr_review: file.ralph?.skills?.pr_review ?? DEFAULT_CONFIG.ralph.skills.pr_review,
+            },
+        },
+    };
+}
+/**
+ * Get the default configuration (no file, no env vars).
+ * Useful for testing or when config loading fails completely.
+ * Returns a deep copy to prevent mutation of shared defaults.
+ */
+export function getDefaultConfig() {
+    return {
+        shadow: {
+            branch: DEFAULT_CONFIG.shadow.branch,
+            directory: DEFAULT_CONFIG.shadow.directory,
+            remote: DEFAULT_CONFIG.shadow.remote,
+        },
+        identity: { ...DEFAULT_CONFIG.identity },
+        validation: {
+            strict_refs: DEFAULT_CONFIG.validation.strict_refs,
+            require_acceptance: DEFAULT_CONFIG.validation.require_acceptance,
+        },
+        daemon: {
+            port: DEFAULT_CONFIG.daemon.port,
+            host: DEFAULT_CONFIG.daemon.host,
+            auto_start: DEFAULT_CONFIG.daemon.auto_start,
+        },
+        ralph: {
+            skills: { ...DEFAULT_CONFIG.ralph.skills },
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/parser/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/parser/config.ts"],"names":[],"mappings":"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"}

package/dist/parser/convention-validation.d.ts

@@ -3,7 +3,7 @@
  *
  * Validates content against convention rules with domain-specific strategies.
  */
-import type { Convention } from '../schema/meta.js';
+import type { Convention } from "../schema/meta.js";
 /**
  * Convention validation error
  */

package/dist/parser/convention-validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convention-validation.d.ts","sourceRoot":"","sources":["../../src/parser/convention-validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAwB,MAAM,mBAAmB,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,yBAAyB,EAAE,CAAC;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE;QACL,kBAAkB,EAAE,MAAM,CAAC;QAC3B,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AA8GD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,UAAU,GACrB,yBAAyB,GAAG,IAAI,CAyBlC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,UAAU,EAAE,EACzB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,0BAA0B,CAsC5B"}
+{"version":3,"file":"convention-validation.d.ts","sourceRoot":"","sources":["../../src/parser/convention-validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAwB,MAAM,mBAAmB,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,yBAAyB,EAAE,CAAC;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE;QACL,kBAAkB,EAAE,MAAM,CAAC;QAC3B,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAsHD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,UAAU,GACrB,yBAAyB,GAAG,IAAI,CAyBlC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,UAAU,EAAE,EACzB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,0BAA0B,CAsC5B"}

package/dist/parser/convention-validation.js

@@ -10,7 +10,7 @@ function validateRegex(content, validation, domain) {
     if (!validation.pattern) {
         return {
             domain,
-            message: 'Regex validation requires a pattern',
+            message: "Regex validation requires a pattern",
         };
     }
     try {
@@ -38,14 +38,14 @@ function validateEnum(content, validation, domain) {
     if (!validation.allowed || validation.allowed.length === 0) {
         return {
             domain,
-            message: 'Enum validation requires an allowed list',
+            message: "Enum validation requires an allowed list",
         };
     }
     if (!validation.allowed.includes(content.trim())) {
         return {
             domain,
             message: validation.message || `Value not in allowed list`,
-            expected: `One of: ${validation.allowed.join(', ')}`,
+            expected: `One of: ${validation.allowed.join(", ")}`,
         };
     }
     return null;
@@ -54,17 +54,20 @@ function validateEnum(content, validation, domain) {
  * Validate content against a range (word count, character count, or line count)
  */
 function validateRange(content, validation, domain) {
-    const unit = validation.unit || 'words';
+    const unit = validation.unit || "words";
     let count;
     switch (unit) {
-        case 'words':
-            count = content.trim().split(/\s+/).filter(w => w.length > 0).length;
+        case "words":
+            count = content
+                .trim()
+                .split(/\s+/)
+                .filter((w) => w.length > 0).length;
             break;
-        case 'chars':
+        case "chars":
             count = content.length;
             break;
-        case 'lines':
-            count = content.split('\n').length;
+        case "lines":
+            count = content.split("\n").length;
             break;
         default:
             return {
@@ -77,13 +80,15 @@ function validateRange(content, validation, domain) {
     if (min !== undefined && count < min) {
         return {
             domain,
-            message: validation.message || `Content too short: ${count} ${unit}, minimum ${min} ${unit}`,
+            message: validation.message ||
+                `Content too short: ${count} ${unit}, minimum ${min} ${unit}`,
         };
     }
     if (max !== undefined && count > max) {
         return {
             domain,
-            message: validation.message || `Content too long: ${count} ${unit}, maximum ${max} ${unit}`,
+            message: validation.message ||
+                `Content too long: ${count} ${unit}, maximum ${max} ${unit}`,
         };
     }
     return null;
@@ -103,13 +108,13 @@ export function validateConvention(content, convention) {
     const { validation } = convention;
     const domain = convention.domain;
     switch (validation.type) {
-        case 'regex':
+        case "regex":
             return validateRegex(content, validation, domain);
-        case 'enum':
+        case "enum":
             return validateEnum(content, validation, domain);
-        case 'range':
+        case "range":
             return validateRange(content, validation, domain);
-        case 'prose':
+        case "prose":
             // Prose conventions are advisory only - no validation
             return null;
         default:
@@ -139,7 +144,7 @@ export function validateConventions(conventions, contentMap) {
             skipped.push(convention.domain);
             continue;
         }
-        if (convention.validation.type === 'prose') {
+        if (convention.validation.type === "prose") {
             skipped.push(convention.domain);
             continue;
         }

package/dist/parser/convention-validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"convention-validation.js","sourceRoot":"","sources":["../../src/parser/convention-validation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"convention-validation.js","sourceRoot":"","sources":["../../src/parser/convention-validation.ts"],"names":[],"mappings":"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"}

package/dist/parser/coverage-cache.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Test coverage cache for daemon performance optimization.
+ *
+ * Caches scanTestCoverage() results to avoid re-scanning test files
+ * on every API request. The cache is per-project-directory and supports:
+ * - TTL-based expiration (default 60 seconds)
+ * - Explicit invalidation for file watcher integration
+ *
+ * @module coverage-cache
+ */
+/**
+ * Get test coverage for a project directory, using cache when available.
+ *
+ * This is the primary API for daemon routes. It:
+ * 1. Returns cached results if valid
+ * 2. Returns in-flight scan result if a scan is already in progress
+ * 3. Otherwise initiates a new scan and caches the result
+ *
+ * @param rootDir - Project root directory containing tests/
+ * @returns Set of covered AC references (e.g., "@spec-ref ac-1")
+ */
+export declare function getCachedTestCoverage(rootDir: string): Promise<Set<string>>;
+/**
+ * Invalidate the test coverage cache for a specific project or all projects.
+ *
+ * Call this when test files change (via file watcher) to ensure
+ * fresh coverage data on next request.
+ *
+ * @param rootDir - Optional project root directory. If omitted, clears all caches.
+ */
+export declare function invalidateTestCoverageCache(rootDir?: string): void;
+/**
+ * Set the cache TTL (for testing purposes).
+ *
+ * @param ms - TTL in milliseconds
+ */
+export declare function setTestCoverageCacheTTL(ms: number): void;
+/**
+ * Reset the cache TTL to default (for testing purposes).
+ */
+export declare function resetTestCoverageCacheTTL(): void;
+/**
+ * Get current cache statistics (for debugging/monitoring).
+ */
+export declare function getTestCoverageCacheStats(): {
+    entries: number;
+    ttlMs: number;
+};
+//# sourceMappingURL=coverage-cache.d.ts.map

package/dist/parser/coverage-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage-cache.d.ts","sourceRoot":"","sources":["../../src/parser/coverage-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA+CH;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAqCtB;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAOlE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAExD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,CAKA"}