@arcbridge/core 0.3.0 → 0.3.1

package/dist/index.js

@@ -1,103 +1,92 @@
 // src/schemas/config.ts
+import { z as z2 } from "zod";
+
+// src/schemas/quality-scenarios.ts
 import { z } from "zod";
-var ServiceSchema = z.object({
+var QualityCategorySchema = z.string().regex(/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/, "Must be lowercase kebab-case (e.g., 'security', 'data-integrity')");
+var QUALITY_PRIORITIES_DESCRIPTION = "Quality priorities in order. Common: security, performance, accessibility, reliability, maintainability, usability, portability, compatibility. Custom categories like data-integrity or compliance are also supported.";
+var QualityPrioritySchema = z.enum(["must", "should", "could"]);
+var QualityScenarioStatusSchema = z.enum([
+  "passing",
+  "failing",
+  "untested",
+  "partial"
+]);
+var QualityScenarioSchema = z.object({
+  id: z.string().regex(/^[A-Z0-9]+-\d+$/, "Must match pattern like SEC-01"),
   name: z.string().min(1),
-  path: z.string().default("."),
-  type: z.enum(["nextjs", "react", "fastify", "express", "hono", "dotnet", "unity"]),
-  tsconfig: z.string().optional(),
-  csproj: z.string().optional()
+  category: QualityCategorySchema,
+  priority: QualityPrioritySchema,
+  scenario: z.string().min(1),
+  expected: z.string().min(1),
+  linked_code: z.array(z.string()).default([]),
+  linked_tests: z.array(z.string()).default([]),
+  linked_blocks: z.array(z.string()).default([]),
+  verification: z.enum(["automatic", "manual", "semi-automatic"]),
+  status: QualityScenarioStatusSchema.default("untested")
+});
+var QualityGoalSchema = z.object({
+  id: QualityCategorySchema,
+  priority: z.number().int().min(1),
+  description: z.string().min(1)
 });
-var ArcBridgeConfigSchema = z.object({
+var QualityScenariosFileSchema = z.object({
   schema_version: z.literal(1).default(1),
-  project_name: z.string().min(1),
-  project_type: z.enum([
+  last_updated: z.string(),
+  quality_goals: z.array(QualityGoalSchema),
+  scenarios: z.array(QualityScenarioSchema)
+});
+
+// src/schemas/config.ts
+var ServiceSchema = z2.object({
+  name: z2.string().min(1),
+  path: z2.string().default("."),
+  type: z2.enum(["nextjs", "react", "fastify", "express", "hono", "dotnet", "unity"]),
+  tsconfig: z2.string().optional(),
+  csproj: z2.string().optional()
+});
+var ArcBridgeConfigSchema = z2.object({
+  schema_version: z2.literal(1).default(1),
+  project_name: z2.string().min(1),
+  project_type: z2.enum([
     "nextjs-app-router",
     "react-vite",
     "api-service",
     "dotnet-webapi",
     "unity-game"
   ]).default("nextjs-app-router"),
-  services: z.array(ServiceSchema).default([]),
-  platforms: z.array(z.enum(["claude", "copilot", "gemini", "codex"])).default(["claude"]),
-  quality_priorities: z.array(
-    z.enum([
-      "security",
-      "performance",
-      "accessibility",
-      "reliability",
-      "maintainability"
-    ])
-  ).default(["security", "performance", "accessibility"]),
-  indexing: z.object({
-    include: z.array(z.string()).default(["src/**/*", "app/**/*"]),
-    exclude: z.array(z.string()).default(["node_modules", "dist", ".next", "coverage"]),
-    default_mode: z.enum(["fast", "deep"]).default("fast"),
-    csharp_indexer: z.enum(["auto", "roslyn", "tree-sitter"]).default("auto").describe(
+  services: z2.array(ServiceSchema).default([]),
+  platforms: z2.array(z2.enum(["claude", "copilot", "gemini", "codex"])).default(["claude"]),
+  quality_priorities: z2.array(QualityCategorySchema).default(["security", "performance", "accessibility"]).describe(QUALITY_PRIORITIES_DESCRIPTION),
+  indexing: z2.object({
+    include: z2.array(z2.string()).default(["src/**/*", "app/**/*"]),
+    exclude: z2.array(z2.string()).default(["node_modules", "dist", ".next", "coverage"]),
+    default_mode: z2.enum(["fast", "deep"]).default("fast"),
+    csharp_indexer: z2.enum(["auto", "roslyn", "tree-sitter"]).default("auto").describe(
       "C# indexer backend: 'auto' prefers the arcbridge-dotnet-indexer global tool, falls back to monorepo source if dotnet CLI is available, else tree-sitter. 'tree-sitter' works without .NET SDK. 'roslyn' requires global tool or monorepo source + .NET SDK."
     )
   }).default({}),
-  testing: z.object({
-    test_command: z.string().min(1).default("npx vitest run").describe("Command to run tests (space-separated, no shell syntax). File paths are appended as arguments."),
-    timeout_ms: z.number().int().min(1e3).default(6e4).describe("Timeout per test run in milliseconds")
+  testing: z2.object({
+    test_command: z2.string().min(1).default("npx vitest run").describe("Command to run tests (space-separated, no shell syntax). File paths are appended as arguments."),
+    timeout_ms: z2.number().int().min(1e3).default(6e4).describe("Timeout per test run in milliseconds")
   }).default({}),
-  drift: z.object({
-    ignore_paths: z.array(z.string()).default([]).describe(
+  drift: z2.object({
+    ignore_paths: z2.array(z2.string()).default([]).describe(
       "File paths or prefixes to ignore in undocumented_module drift checks. Framework files (e.g. next.config.ts, root layout/page) are auto-ignored for known project types."
     )
   }).default({}),
-  metrics: z.object({
-    auto_record: z.boolean().default(false).describe(
+  metrics: z2.object({
+    auto_record: z2.boolean().default(false).describe(
       "Automatically record agent activity (tool name, duration, quality snapshot) when key MCP tools are invoked. Token/model info is optional and caller-provided."
     )
   }).default({}),
-  sync: z.object({
-    auto_detect_drift: z.boolean().default(true),
-    drift_severity_threshold: z.enum(["info", "warning", "error"]).default("warning"),
-    propose_updates_on: z.enum(["session-end", "phase-complete", "manual"]).default("phase-complete")
+  sync: z2.object({
+    auto_detect_drift: z2.boolean().default(true),
+    drift_severity_threshold: z2.enum(["info", "warning", "error"]).default("warning"),
+    propose_updates_on: z2.enum(["session-end", "phase-complete", "manual"]).default("phase-complete")
   }).default({})
 });
 
-// src/schemas/quality-scenarios.ts
-import { z as z2 } from "zod";
-var QualityCategorySchema = z2.enum([
-  "security",
-  "performance",
-  "accessibility",
-  "reliability",
-  "maintainability"
-]);
-var QualityPrioritySchema = z2.enum(["must", "should", "could"]);
-var QualityScenarioStatusSchema = z2.enum([
-  "passing",
-  "failing",
-  "untested",
-  "partial"
-]);
-var QualityScenarioSchema = z2.object({
-  id: z2.string().regex(/^[A-Z0-9]+-\d+$/, "Must match pattern like SEC-01"),
-  name: z2.string().min(1),
-  category: QualityCategorySchema,
-  priority: QualityPrioritySchema,
-  scenario: z2.string().min(1),
-  expected: z2.string().min(1),
-  linked_code: z2.array(z2.string()).default([]),
-  linked_tests: z2.array(z2.string()).default([]),
-  linked_blocks: z2.array(z2.string()).default([]),
-  verification: z2.enum(["automatic", "manual", "semi-automatic"]),
-  status: QualityScenarioStatusSchema.default("untested")
-});
-var QualityGoalSchema = z2.object({
-  id: QualityCategorySchema,
-  priority: z2.number().int().min(1),
-  description: z2.string().min(1)
-});
-var QualityScenariosFileSchema = z2.object({
-  schema_version: z2.literal(1).default(1),
-  last_updated: z2.string(),
-  quality_goals: z2.array(QualityGoalSchema),
-  scenarios: z2.array(QualityScenarioSchema)
-});
-
 // src/schemas/building-blocks.ts
 import { z as z3 } from "zod";
 var BuildingBlockSchema = z3.object({
@@ -7280,20 +7269,26 @@ function safeParseJson(value, fallback) {
 import { join as join15 } from "path";
 import { existsSync as existsSync8, readFileSync as readFileSync8, writeFileSync as writeFileSync5, mkdirSync as mkdirSync5, unlinkSync } from "fs";
 import { parse as parse2, stringify as stringify4 } from "yaml";
+function readTaskFile(projectRoot, phaseId) {
+  const path = join15(projectRoot, ".arcbridge", "plan", "tasks", `${phaseId}.yaml`);
+  if (!existsSync8(path)) return { error: "not-found" };
+  const raw = readFileSync8(path, "utf-8");
+  const result = TaskFileSchema.safeParse(parse2(raw));
+  if (!result.success) return { error: "invalid" };
+  return { data: result.data, path };
+}
+function readPhasesFile(projectRoot) {
+  const path = join15(projectRoot, ".arcbridge", "plan", "phases.yaml");
+  if (!existsSync8(path)) return { error: "not-found" };
+  const raw = readFileSync8(path, "utf-8");
+  const result = PhasesFileSchema.safeParse(parse2(raw));
+  if (!result.success) return { error: "invalid" };
+  return { data: result.data, path };
+}
 function syncTaskToYaml(projectRoot, phaseId, taskId, status, completedAt) {
-  const taskPath = join15(
-    projectRoot,
-    ".arcbridge",
-    "plan",
-    "tasks",
-    `${phaseId}.yaml`
-  );
-  if (!existsSync8(taskPath)) return;
-  const raw = readFileSync8(taskPath, "utf-8");
-  const parsed = parse2(raw);
-  const result = TaskFileSchema.safeParse(parsed);
-  if (!result.success) return;
-  const taskFile = result.data;
+  const readResult = readTaskFile(projectRoot, phaseId);
+  if ("error" in readResult) return;
+  const { data: taskFile, path: taskPath } = readResult;
   const task = taskFile.tasks.find((t) => t.id === taskId);
   if (!task) return;
   task.status = status;
@@ -7306,39 +7301,19 @@ function syncTaskToYaml(projectRoot, phaseId, taskId, status, completedAt) {
 }
 function addTaskToYaml(projectRoot, phaseId, task) {
   const tasksDir = join15(projectRoot, ".arcbridge", "plan", "tasks");
-  const taskPath = join15(tasksDir, `${phaseId}.yaml`);
   mkdirSync5(tasksDir, { recursive: true });
-  let taskFile;
-  if (existsSync8(taskPath)) {
-    const raw = readFileSync8(taskPath, "utf-8");
-    const parsed = parse2(raw);
-    const result = TaskFileSchema.safeParse(parsed);
-    if (result.success) {
-      taskFile = result.data;
-    } else {
-      taskFile = { schema_version: 1, phase_id: phaseId, tasks: [] };
-    }
-  } else {
-    taskFile = { schema_version: 1, phase_id: phaseId, tasks: [] };
-  }
+  const readResult = readTaskFile(projectRoot, phaseId);
+  const taskFile = "error" in readResult ? { schema_version: 1, phase_id: phaseId, tasks: [] } : readResult.data;
   if (!taskFile.tasks.some((t) => t.id === task.id)) {
     taskFile.tasks.push(task);
   }
+  const taskPath = join15(tasksDir, `${phaseId}.yaml`);
   writeFileSync5(taskPath, stringify4(taskFile), "utf-8");
 }
 function syncPhaseToYaml(projectRoot, phaseId, status, startedAt, completedAt) {
-  const phasesPath = join15(
-    projectRoot,
-    ".arcbridge",
-    "plan",
-    "phases.yaml"
-  );
-  if (!existsSync8(phasesPath)) return;
-  const raw = readFileSync8(phasesPath, "utf-8");
-  const parsed = parse2(raw);
-  const result = PhasesFileSchema.safeParse(parsed);
-  if (!result.success) return;
-  const phasesFile = result.data;
+  const readResult = readPhasesFile(projectRoot);
+  if ("error" in readResult) return;
+  const { data: phasesFile, path: phasesPath } = readResult;
   const phase = phasesFile.phases.find((p) => p.id === phaseId);
   if (!phase) return;
   phase.status = status;
@@ -7348,21 +7323,14 @@ function syncPhaseToYaml(projectRoot, phaseId, status, startedAt, completedAt) {
 }
 function addPhaseToYaml(projectRoot, phase) {
   try {
-    const phasesPath = join15(
-      projectRoot,
-      ".arcbridge",
-      "plan",
-      "phases.yaml"
-    );
-    if (!existsSync8(phasesPath)) {
-      return { success: false, warning: "phases.yaml not found" };
-    }
-    const raw = readFileSync8(phasesPath, "utf-8");
-    const result = PhasesFileSchema.safeParse(parse2(raw));
-    if (!result.success) {
-      return { success: false, warning: "phases.yaml failed validation" };
+    const readResult = readPhasesFile(projectRoot);
+    if ("error" in readResult) {
+      return {
+        success: false,
+        warning: readResult.error === "not-found" ? "phases.yaml not found" : "phases.yaml failed validation"
+      };
     }
-    const phasesFile = result.data;
+    const { data: phasesFile, path: phasesPath } = readResult;
     const existingById = phasesFile.phases.some((p) => p.id === phase.id);
     const existingByNumber = phasesFile.phases.some((p) => p.phase_number === phase.phase_number);
     if (existingByNumber && !existingById) {
@@ -7429,25 +7397,17 @@ function syncScenarioToYaml(projectRoot, scenarioId, status, linkedTests, verifi
 }
 function deleteTaskFromYaml(projectRoot, phaseId, taskId) {
   try {
-    const taskPath = join15(
-      projectRoot,
-      ".arcbridge",
-      "plan",
-      "tasks",
-      `${phaseId}.yaml`
-    );
-    if (!existsSync8(taskPath)) {
-      return { success: true };
-    }
-    const raw = readFileSync8(taskPath, "utf-8");
-    const result = TaskFileSchema.safeParse(parse2(raw));
-    if (!result.success) {
+    const readResult = readTaskFile(projectRoot, phaseId);
+    if ("error" in readResult) {
+      if (readResult.error === "not-found") {
+        return { success: true };
+      }
       return {
         success: false,
         warning: `Could not parse ${phaseId}.yaml \u2014 task may reappear after reindex`
       };
     }
-    const taskFile = result.data;
+    const { data: taskFile, path: taskPath } = readResult;
     const before = taskFile.tasks.length;
     taskFile.tasks = taskFile.tasks.filter((t) => t.id !== taskId);
     if (taskFile.tasks.length === before) {
@@ -7464,19 +7424,14 @@ function deleteTaskFromYaml(projectRoot, phaseId, taskId) {
 }
 function deletePhaseFromYaml(projectRoot, phaseId) {
   try {
-    const phasesPath = join15(projectRoot, ".arcbridge", "plan", "phases.yaml");
-    if (!existsSync8(phasesPath)) {
-      return { success: false, warning: "phases.yaml not found" };
-    }
-    const raw = readFileSync8(phasesPath, "utf-8");
-    const result = PhasesFileSchema.safeParse(parse2(raw));
-    if (!result.success) {
+    const readResult = readPhasesFile(projectRoot);
+    if ("error" in readResult) {
       return {
         success: false,
-        warning: "Could not parse phases.yaml \u2014 phase may reappear after reindex"
+        warning: readResult.error === "not-found" ? "phases.yaml not found" : "Could not parse phases.yaml \u2014 phase may reappear after reindex"
       };
     }
-    const phasesFile = result.data;
+    const { data: phasesFile, path: phasesPath } = readResult;
     const before = phasesFile.phases.length;
     phasesFile.phases = phasesFile.phases.filter((p) => p.id !== phaseId);
     if (phasesFile.phases.length === before) {
@@ -8464,6 +8419,7 @@ export {
   CURRENT_SCHEMA_VERSION,
   PhaseSchema,
   PhasesFileSchema,
+  QUALITY_PRIORITIES_DESCRIPTION,
   QualityCategorySchema,
   QualityPrioritySchema,
   QualityScenarioSchema,