@arcbridge/core 0.1.5 → 0.1.6

package/dist/index.d.ts

@@ -908,6 +908,19 @@ declare function addTaskToYaml(projectRoot: string, phaseId: string, task: {
  * Update a phase's status in phases.yaml.
  */
 declare function syncPhaseToYaml(projectRoot: string, phaseId: string, status: string, startedAt?: string | null, completedAt?: string | null): void;
+/**
+ * Add a new phase to the phases.yaml file.
+ */
+declare function addPhaseToYaml(projectRoot: string, phase: {
+    id: string;
+    name: string;
+    phase_number: number;
+    description: string;
+    gate_requirements?: string[];
+}): {
+    success: boolean;
+    warning?: string;
+};
 /**
  * Update a quality scenario's status in 10-quality-scenarios.yaml.
  */
@@ -1123,4 +1136,4 @@ declare function loadConfig(projectRoot: string): {
     error: string | null;
 };
 
-export { type ActivityRow, type AdrFrontmatter, AdrFrontmatterSchema, type AgentRole, AgentRoleSchema, type AggregatedRow, type ArcBridgeConfig, ArcBridgeConfigSchema, type BuildingBlock, BuildingBlockSchema, type BuildingBlocksFrontmatter, BuildingBlocksFrontmatterSchema, CURRENT_SCHEMA_VERSION, type ChangedFile, type Database, type DotnetProjectInfo, type DriftEntry, type DriftKind, type DriftOptions, type DriftSeverity, type ExportFormat, type ExtractedSymbol, type GenerateDatabaseResult, type GitRef, type IndexResult, type IndexerOptions, type InitProjectInput, type InsertActivityParams, type LatestQualitySnapshot, type LoadRolesResult, type MetricsResult, type Phase, PhaseSchema, type PhasesFile, PhasesFileSchema, type ProjectLanguage, QualityCategorySchema, QualityPrioritySchema, type QualityScenario, QualityScenarioSchema, QualityScenarioStatusSchema, type QualityScenariosFile, QualityScenariosFileSchema, type QueryMetricsParams, type ScenarioTestResult, type Service, type SessionTotals, type SymbolKind, type Task, type TaskFile, TaskFileSchema, type TaskInferenceResult, TaskSchema, type TestOutcome, type VerifyResult, addTaskToYaml, applyInferences, deleteTaskFromYaml, detectDrift, detectProjectLanguage, discoverDotnetServices, exportMetrics, generateAgentRoles, generateArc42, generateConfig, generateDatabase, generatePlan, generateSyncFiles, getChangedFiles, getHeadSha, getSessionTotals, getUncommittedChanges, indexPackageDependencies, indexProject, inferTaskStatuses, initializeSchema, insertActivity, loadConfig, loadRole, loadRoles, migrate, openDatabase, openMemoryDatabase, queryMetrics, refreshFromDocs, resolveRef, scopeToProject, setSyncCommit, suppressSqliteWarning, syncPhaseToYaml, syncScenarioToYaml, syncTaskToYaml, transaction, verifyScenarios, writeDriftLog };
+export { type ActivityRow, type AdrFrontmatter, AdrFrontmatterSchema, type AgentRole, AgentRoleSchema, type AggregatedRow, type ArcBridgeConfig, ArcBridgeConfigSchema, type BuildingBlock, BuildingBlockSchema, type BuildingBlocksFrontmatter, BuildingBlocksFrontmatterSchema, CURRENT_SCHEMA_VERSION, type ChangedFile, type Database, type DotnetProjectInfo, type DriftEntry, type DriftKind, type DriftOptions, type DriftSeverity, type ExportFormat, type ExtractedSymbol, type GenerateDatabaseResult, type GitRef, type IndexResult, type IndexerOptions, type InitProjectInput, type InsertActivityParams, type LatestQualitySnapshot, type LoadRolesResult, type MetricsResult, type Phase, PhaseSchema, type PhasesFile, PhasesFileSchema, type ProjectLanguage, QualityCategorySchema, QualityPrioritySchema, type QualityScenario, QualityScenarioSchema, QualityScenarioStatusSchema, type QualityScenariosFile, QualityScenariosFileSchema, type QueryMetricsParams, type ScenarioTestResult, type Service, type SessionTotals, type SymbolKind, type Task, type TaskFile, TaskFileSchema, type TaskInferenceResult, TaskSchema, type TestOutcome, type VerifyResult, addPhaseToYaml, addTaskToYaml, applyInferences, deleteTaskFromYaml, detectDrift, detectProjectLanguage, discoverDotnetServices, exportMetrics, generateAgentRoles, generateArc42, generateConfig, generateDatabase, generatePlan, generateSyncFiles, getChangedFiles, getHeadSha, getSessionTotals, getUncommittedChanges, indexPackageDependencies, indexProject, inferTaskStatuses, initializeSchema, insertActivity, loadConfig, loadRole, loadRoles, migrate, openDatabase, openMemoryDatabase, queryMetrics, refreshFromDocs, resolveRef, scopeToProject, setSyncCommit, suppressSqliteWarning, syncPhaseToYaml, syncScenarioToYaml, syncTaskToYaml, transaction, verifyScenarios, writeDriftLog };

package/dist/index.js

@@ -2978,7 +2978,7 @@ You are responsible for maintaining these sections in \`.arcbridge/arc42/\`. Upd
 
 At the start of a project (after init), plan the full roadmap:
 - **ArcBridge generates 4 phases as a starting template** (Setup, Foundation, Features, Polish). These are a baseline \u2014 adapt them to your project's actual scope and complexity.
-- **For larger projects, add more phases** by editing \`.arcbridge/plan/phases.yaml\` and running \`arcbridge_reindex\`. Split "Core Features" into multiple phases if needed (e.g., "Phase 2: Auth & Users", "Phase 3: Core Business Logic", "Phase 4: Integrations", "Phase 5: Polish").
+- **For larger projects, add more phases** using \`arcbridge_create_phase\`. Split "Core Features" into multiple phases if needed (e.g., "Auth & Users", "Core Business Logic", "Integrations", "Polish").
 - **Phase 0-1 tasks are ready to use** \u2014 they cover setup and foundation for this template
 - **Phase 2+ tasks are examples** \u2014 replace them with real tasks derived from the project's requirements and specifications
 - Review the phase plan with \`arcbridge_get_phase_plan\` and replace example tasks with project-specific ones
@@ -3213,6 +3213,7 @@ function phaseManagerTemplate() {
       "arcbridge_update_task",
       "arcbridge_delete_task",
       "arcbridge_create_task",
+      "arcbridge_create_phase",
       "arcbridge_check_drift",
       "arcbridge_verify_scenarios",
       "arcbridge_update_scenario_status",
@@ -3250,7 +3251,7 @@ function phaseManagerTemplate() {
 ## Task Planning
 
 Before starting any phase, ensure proper task planning:
-- **ArcBridge generates 4 phases as a starting template.** For larger projects, add more phases by editing \`.arcbridge/plan/phases.yaml\` and running \`arcbridge_reindex\`.
+- **ArcBridge generates 4 phases as a starting template.** For larger projects, add more phases using \`arcbridge_create_phase\`.
 - **Phase 0-1 tasks are concrete** \u2014 they cover project setup and foundation. Follow them as-is.
 - **Phase 2+ tasks are examples only** \u2014 they show the *shape* of later phases but must be replaced with real tasks derived from the project's actual requirements and specs.
 - **At project start, plan ALL phases** \u2014 review \`arcbridge_get_phase_plan\`, delete example tasks in Phase 2+ using \`arcbridge_delete_task\`, and create real tasks based on the product spec.
@@ -6627,6 +6628,63 @@ function syncPhaseToYaml(projectRoot, phaseId, status, startedAt, completedAt) {
   if (completedAt) phase.completed_at = completedAt;
   writeFileSync5(phasesPath, stringify4(phasesFile), "utf-8");
 }
+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 phasesFile = result.data;
+    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) {
+      const conflicting = phasesFile.phases.find((p) => p.phase_number === phase.phase_number);
+      return {
+        success: false,
+        warning: `Phase number ${phase.phase_number} already used by '${conflicting?.id}'`
+      };
+    }
+    const tasksDir = join15(projectRoot, ".arcbridge", "plan", "tasks");
+    mkdirSync5(tasksDir, { recursive: true });
+    const taskFilePath = join15(tasksDir, `${phase.id}.yaml`);
+    if (!existsSync8(taskFilePath)) {
+      writeFileSync5(
+        taskFilePath,
+        stringify4({ schema_version: 1, phase_id: phase.id, tasks: [] }),
+        "utf-8"
+      );
+    }
+    if (existingById) {
+      return { success: true };
+    }
+    phasesFile.phases.push({
+      id: phase.id,
+      name: phase.name,
+      phase_number: phase.phase_number,
+      status: "planned",
+      description: phase.description,
+      gate_requirements: phase.gate_requirements ?? []
+    });
+    phasesFile.phases.sort((a, b) => a.phase_number - b.phase_number);
+    writeFileSync5(phasesPath, stringify4(phasesFile), "utf-8");
+    return { success: true };
+  } catch (err) {
+    return {
+      success: false,
+      warning: `YAML write failed: ${err instanceof Error ? err.message : String(err)}`
+    };
+  }
+}
 function syncScenarioToYaml(projectRoot, scenarioId, status, linkedTests, verification) {
   const scenarioPath = join15(
     projectRoot,
@@ -7660,6 +7718,7 @@ export {
   QualityScenariosFileSchema,
   TaskFileSchema,
   TaskSchema,
+  addPhaseToYaml,
   addTaskToYaml,
   applyInferences,
   deleteTaskFromYaml,