code-ai-installer 2.5.0 → 4.0.0

package/dist/shared/vocabulary.js

@@ -0,0 +1,163 @@
+import { z } from "zod";
+/**
+ * Controlled vocabulary for the code-ai system.
+ *
+ * Every enum here is a closed set. Extensions go through
+ * `request_decision` → ADR → version bump of the shared types module (src/shared), then
+ * propagate atomically to both consumers (installer + mcp).
+ *
+ * Sourced from: docs/architecture-redesign/2026-05-23-context.md
+ *               (sections: STRUCTURED METADATA, ARTEFACTS AND LIMITS).
+ */
+// ─── Pipeline mode ────────────────────────────────────────────────────────────
+/** Three pipeline shapes per domain. Full = all gates; Bugfix = compressed; Hotfix = single RG gate. */
+export const PipelineMode = z.enum(["full", "bugfix", "hotfix"]);
+// ─── Gates ────────────────────────────────────────────────────────────────────
+/** Full development pipeline (8 gates). Other domains may use a subset; pipeline.yaml declares which. */
+export const GateName = z.enum([
+    "PM",
+    "UX",
+    "ARCH",
+    "DEV",
+    "REV",
+    "OPS",
+    "TEST",
+    "RG",
+]);
+// ─── Classification (the only decision channel before each gate transition) ──
+/**
+ * LLM MUST classify each gate before producing artifact. Per the silent-by-default contract:
+ *   - auto_resolve: green path, no DEN attention required, artifact still produced for audit
+ *   - fork:        decision-point that needs DEN — surfaces via request_decision
+ *   - exception:   automated check failed, breakdown written to exception channel
+ */
+export const ClassificationOutcome = z.enum([
+    "auto_resolve",
+    "fork",
+    "exception",
+]);
+// ─── Artifact classes (with hard line caps) ──────────────────────────────────
+/** Every write goes through submit_artifact, which enforces the line cap declared here. */
+export const ArtifactClass = z.enum([
+    "adr",
+    "persona",
+    "skill",
+    "role",
+    "diary",
+    "working_report",
+    "handoff",
+    "memory_index",
+]);
+/** Hard caps from 2026-05-23-context.md § ARTIFACTS AND LIMITS. */
+export const ARTIFACT_LINE_CAP = {
+    adr: 150,
+    persona: 200,
+    skill: 300,
+    role: 250,
+    diary: null,
+    working_report: null,
+    handoff: 300,
+    memory_index: 200,
+};
+// ─── Domain ──────────────────────────────────────────────────────────────────
+/** Top-level domain that owns a pipeline. */
+export const DomainId = z.enum([
+    "development",
+    "content",
+    "analytics",
+    "product",
+]);
+// ─── Skill typing (metric-determining) ───────────────────────────────────────
+/**
+ * Per 2026-05-23-context.md § МЕТРИКИ SKILLS:
+ *   mandatory     → compliance in outputs, not invocation count
+ *   triggered     → trigger accuracy
+ *   reference     → recall on missed opportunities (MCP actively hints via PreToolUse)
+ *   discretionary → standard up/neutral/down rating
+ */
+export const SkillType = z.enum([
+    "mandatory",
+    "triggered",
+    "reference",
+    "discretionary",
+]);
+// ─── Signers (who can sign off a gate) ───────────────────────────────────────
+/** "den" = the user. "mcp" = auto-pass via deterministic check. "system" = circuit-breaker / audit. */
+export const Signer = z.enum(["den", "mcp", "system"]);
+// ─── Controlled vocab seeds (extendable via request_decision) ───────────────
+/**
+ * tech + topic enums are seeded at migration start (<=30 each per plan).
+ * MCP refuses unknown values at submit_artifact time.
+ * Use z.string() with refine() in consumers when the curated list is loaded from disk;
+ * the seeds here are placeholders for compile-time safety on shipped skills.
+ */
+export const TechSeed = z.enum([
+    "typescript",
+    "node",
+    "react",
+    "python",
+    "go",
+    "rust",
+    "monaco",
+    "vscode",
+    "mongodb",
+    "postgres",
+    "docker",
+    "playwright",
+    "vitest",
+    "general",
+    // Added 2026-05-24 from 72-skill dev-domain audit:
+    "a11y",
+    "css",
+    "express",
+    "n8n",
+    "rtk",
+    "tailwind",
+    "tanstack",
+    "wix",
+    "bun",
+    "biome",
+    "k8s",
+    "zustand",
+    // Added 2026-05-27 for Tester arc DEV-079 (qa-mutation-testing):
+    "stryker",
+    "mutmut",
+    // Added 2026-05-27 for Tester arc DEV-080 (qa-property-based-testing):
+    "fast-check",
+    "hypothesis",
+    // Added 2026-05-27 for Tester arc DEV-081 (qa-test-integrity-audit):
+    "eslint",
+    "ruff",
+    // Added 2026-05-27 for Tester arc DEV-082 (qa-flaky-test-protocol):
+    "pytest",
+    // Added 2026-05-27 for Tester arc DEV-083 (qa-test-data-management):
+    "faker",
+    "factory_boy",
+    // Added 2026-05-29 for Test Integrity Initiative DEV-094 (test-integrity-hooks-setup):
+    "husky",
+    "pre-commit",
+]);
+export const TopicSeed = z.enum([
+    "architecture",
+    "refactoring",
+    "testing",
+    "security",
+    "performance",
+    "documentation",
+    "design-patterns",
+    "data-modelling",
+    "legacy",
+    "ux",
+    "review",
+    "ops",
+    "general",
+    // Added 2026-05-24 from 72-skill dev-domain audit (AGENTS.md sections):
+    "pm",
+    "orchestration",
+    "qa",
+    "design-systems",
+    "observability",
+    "a11y",
+    "compliance",
+    "release",
+]);

package/dist/sourceResolver.d.ts

@@ -1,6 +1,7 @@
-import type { TemplateLanguage } from "./types.js";
 /**
- * Resolves source root with agent templates.
+ * Resolves source root containing the domains/ layout.
+ * Prefers --project-dir > cwd (if valid) > bundled packageRoot.
+ * Language-specific resolution happens later in domainResolver.
  * @param args Resolution arguments.
  * @returns Absolute source root path.
  */
@@ -8,5 +9,4 @@ export declare function resolveSourceRoot(args: {
     projectDirOption?: string;
     cwd: string;
     packageRoot: string;
-    language: TemplateLanguage;
 }): Promise<string>;

package/dist/sourceResolver.js

@@ -1,79 +1,31 @@
 import path from "node:path";
 import fs from "fs-extra";
 /**
- * Resolves source root with agent templates.
+ * Resolves source root containing the domains/ layout.
+ * Prefers --project-dir > cwd (if valid) > bundled packageRoot.
+ * Language-specific resolution happens later in domainResolver.
  * @param args Resolution arguments.
  * @returns Absolute source root path.
  */
 export async function resolveSourceRoot(args) {
     if (args.projectDirOption) {
         const explicitPath = path.resolve(args.projectDirOption);
-        if (await isValidSourceRoot(explicitPath)) {
+        if (await hasDomainsLayout(explicitPath)) {
             return explicitPath;
         }
-        throw new Error(`Invalid --project-dir: ${explicitPath}. Required: AGENTS.md, agents/, and .agents/ with .agents/skills/, .agents/workflows/, or a legacy flat skill layout.`);
+        throw new Error(`Invalid --project-dir: ${explicitPath}. Required: domains/ with at least one valid domain.json.`);
     }
-    const bundledPath = getBundledPath(args.packageRoot, args.language);
     const cwdPath = path.resolve(args.cwd);
-    if (args.language === "en") {
-        if (await isValidSourceRoot(bundledPath)) {
-            return bundledPath;
-        }
-        if (await isValidSourceRoot(cwdPath)) {
-            return cwdPath;
-        }
+    if (await hasDomainsLayout(cwdPath)) {
+        return cwdPath;
     }
-    else {
-        if (await isValidSourceRoot(cwdPath)) {
-            return cwdPath;
-        }
-        if (await isValidSourceRoot(bundledPath)) {
-            return bundledPath;
-        }
+    if (await hasDomainsLayout(args.packageRoot)) {
+        return args.packageRoot;
     }
-    throw new Error(`Could not find source templates in current directory or bundled package. Checked: ${cwdPath} and ${bundledPath}`);
+    throw new Error(`Could not find source templates. Checked: ${cwdPath} and ${args.packageRoot}`);
 }
 /**
- * Checks whether directory contains required source assets.
- * Accepts legacy root layout (AGENTS.md + agents/ + .agents/) OR
- * domain layout (domains/ with at least one valid domain.json) OR both.
- * @param rootDir Candidate root directory.
- * @returns True when required assets are present.
- */
-async function isValidSourceRoot(rootDir) {
-    if (await hasLegacyLayout(rootDir)) {
-        return true;
-    }
-    return hasDomainsLayout(rootDir);
-}
-/**
- * Checks for legacy root layout: AGENTS.md + agents/ + .agents/ with skills.
- * @param rootDir Candidate root directory.
- * @returns True when legacy assets are present.
- */
-async function hasLegacyLayout(rootDir) {
-    const orchestratorPath = path.join(rootDir, "AGENTS.md");
-    const agentsDir = path.join(rootDir, "agents");
-    const dotAgentsDir = path.join(rootDir, ".agents");
-    if (!(await fs.pathExists(orchestratorPath)) || !(await fs.pathExists(agentsDir)) || !(await fs.pathExists(dotAgentsDir))) {
-        return false;
-    }
-    const nestedSkillsDir = path.join(dotAgentsDir, "skills");
-    const workflowsDir = path.join(dotAgentsDir, "workflows");
-    if ((await fs.pathExists(nestedSkillsDir)) || (await fs.pathExists(workflowsDir))) {
-        return true;
-    }
-    const entries = await fs.readdir(dotAgentsDir);
-    for (const entry of entries) {
-        const legacySkillFile = path.join(dotAgentsDir, entry, "SKILL.md");
-        if (await fs.pathExists(legacySkillFile)) {
-            return true;
-        }
-    }
-    return false;
-}
-/**
- * Checks for domain layout: domains/ with at least one valid domain.json.
+ * Checks for domains/ layout with at least one valid domain.json.
  * @param rootDir Candidate root directory.
  * @returns True when at least one valid domain exists.
  */
@@ -91,15 +43,3 @@ async function hasDomainsLayout(rootDir) {
     }
     return false;
 }
-/**
- * Returns bundled templates root for selected language.
- * @param packageRoot Installed package root.
- * @param language Template language.
- * @returns Absolute bundled source path.
- */
-function getBundledPath(packageRoot, language) {
-    if (language === "en") {
-        return path.resolve(packageRoot, "locales", "en");
-    }
-    return path.resolve(packageRoot);
-}