trackops 2.0.6 → 2.2.0

package/lib/init.js

@@ -102,7 +102,7 @@ function buildDefaultControl(context, options) {
   return {
     meta: {
       projectName: options.name || "My Project",
-      controlVersion: 2,
+      controlVersion: config.DEFAULT_CONTROL_VERSION,
       locale,
       phases,
       updatedAt: nowIso(),
@@ -133,12 +133,31 @@ function buildDefaultControl(context, options) {
         explanationMode: null,
         capturedAt: null,
       },
-      discovery: {
-        projectState: null,
-        documentationState: null,
-        availableArtifacts: [],
-      },
-    },
+      discovery: {
+        projectState: null,
+        documentationState: null,
+        availableArtifacts: [],
+      },
+      quality: {
+        baselineProfile: "baseline",
+        activeProfiles: [],
+        verification: {
+          testCommands: [],
+          buildCommands: [],
+          smokeCommands: [],
+          reviewRequired: false,
+        },
+        lastReportAt: null,
+        lastVerificationAt: null,
+        lastReleaseReadiness: null,
+        lastPromotionReadiness: null,
+      },
+      agentInbox: {
+        pending: [],
+        history: [],
+        lastIssuedAt: null,
+      },
+    },
     checks: {
       lastBuild: { status: "pending", date: null, note: "" },
       lastTest: { status: "pending", date: null, note: "" },
@@ -153,19 +172,30 @@ function buildDefaultControl(context, options) {
     milestones: [],
     decisionsPending: [],
     tasks: [
-      {
-        id: "ops-bootstrap",
-        title: t("init.defaultTaskTitle"),
+      {
+        id: "ops-bootstrap",
+        title: t("init.defaultTaskTitle"),
         phase: phases[0]?.id || "O",
         stream: "Operations",
         priority: "P0",
         status: "pending",
         required: true,
         dependsOn: [],
-        summary: t("init.defaultTaskSummary"),
-        acceptance: [],
-        history: [{ at: nowIso(), action: "create", note: "trackops init" }],
-      },
+        summary: t("init.defaultTaskSummary"),
+        acceptance: [],
+        execution: {
+          owner: config.DEFAULT_EXECUTION_OWNER,
+          lastActor: "system",
+          lastSource: "trackops_init",
+          currentSessionId: null,
+          lastSessionId: null,
+          lastSessionStatus: null,
+          awaitingUserConfirmation: false,
+          verificationPending: false,
+          updatedAt: nowIso(),
+        },
+        history: [{ at: nowIso(), action: "create", note: "trackops init" }],
+      },
     ],
     findings: [],
   };
@@ -300,7 +330,7 @@ function initSplitProject(root, options) {
     control = JSON.parse(fs.readFileSync(controlFile, "utf8"));
     if (!control.meta.phases) control.meta.phases = options.phases || config.buildDefaultPhases(options.locale);
     if (!control.meta.locale) control.meta.locale = options.locale || config.DEFAULT_LOCALE;
-    if (!control.meta.controlVersion || control.meta.controlVersion < 2) control.meta.controlVersion = 2;
+    if (!control.meta.controlVersion || control.meta.controlVersion < config.DEFAULT_CONTROL_VERSION) control.meta.controlVersion = config.DEFAULT_CONTROL_VERSION;
     control.meta.updatedAt = nowIso();
     config.saveControl(context, control);
   } else {
@@ -358,7 +388,7 @@ function initLegacyProject(root, options) {
     const existing = JSON.parse(fs.readFileSync(controlFile, "utf8"));
     if (!existing.meta.phases) existing.meta.phases = options.phases || config.buildDefaultPhases(options.locale);
     if (!existing.meta.locale) existing.meta.locale = options.locale || config.DEFAULT_LOCALE;
-    if (!existing.meta.controlVersion || existing.meta.controlVersion < 2) existing.meta.controlVersion = 2;
+    if (!existing.meta.controlVersion || existing.meta.controlVersion < config.DEFAULT_CONTROL_VERSION) existing.meta.controlVersion = config.DEFAULT_CONTROL_VERSION;
     existing.meta.updatedAt = nowIso();
     fs.writeFileSync(controlFile, `${JSON.stringify(existing, null, 2)}\n`, "utf8");
     console.log(t("init.updated", { file: "project_control.json" }));

package/lib/opera-bootstrap.js

@@ -442,16 +442,27 @@ function buildHandoffPrompt(control, profile) {
     t("handoff.instruction.intakeRequired"),
     "",
     "```json",
-    JSON.stringify({
-      problemStatement: "string — core problem the project solves",
-      targetUser: "string — primary user persona",
-      singularDesiredOutcome: "string — single most important outcome",
-      sourceOfTruth: "string — authoritative data source",
-      payload: "string — what gets delivered (NOT 'deliveryTarget')",
-      decisionOwnership: "user | shared | agent",
-      inputSchema: { "fieldName": "type — at least one key required" },
-      outputSchema: { "fieldName": "type — at least one key required" },
-    }, null, 2),
+    JSON.stringify({
+      problemStatement: "string — core problem the project solves",
+      targetUser: "string — primary user persona",
+      singularDesiredOutcome: "string — single most important outcome",
+      sourceOfTruth: "string — authoritative data source",
+      payload: "string — what gets delivered (NOT 'deliveryTarget')",
+      decisionOwnership: "user | shared | agent",
+      versionControl: {
+        remote: "boolean — whether the project uses a remote VCS",
+        provider: "string — github | gitlab | bitbucket | other",
+        developmentBranch: "string — main development branch",
+        releaseBranch: "string — publish/release branch",
+      },
+      deployment: {
+        mode: "string — manual | ci | platform",
+        target: "string — staging | production | preview | custom",
+        smokeCommand: "string — command to validate a releasable/deployed build",
+      },
+      inputSchema: { "fieldName": "type — at least one key required" },
+      outputSchema: { "fieldName": "type — at least one key required" },
+    }, null, 2),
     "```",
   );
 
@@ -508,13 +519,24 @@ async function collectBootstrapProfile(root, control, options = {}) {
     sourceOfTruth: options.answers?.sourceOfTruth || previous.sourceOfTruth || scan.sourceOfTruthHint || "",
     payload: options.answers?.payload || previous.payload || scan.payloadHint || "",
     behaviorRules: normalizeList(options.answers?.behaviorRules || previous.behaviorRules || ""),
-    inputSchema: options.answers?.inputSchema || previous.inputSchema || {},
-    outputSchema: options.answers?.outputSchema || previous.outputSchema || {},
-    architecturalInvariants: normalizeList(options.answers?.architecturalInvariants || previous.architecturalInvariants || ""),
-    pipeline: normalizeList(options.answers?.pipeline || previous.pipeline || ""),
-    templates: normalizeList(options.answers?.templates || previous.templates || ""),
-    availableArtifacts: Array.isArray(previousDiscovery.availableArtifacts) ? previousDiscovery.availableArtifacts : [],
-  };
+    inputSchema: options.answers?.inputSchema || previous.inputSchema || {},
+    outputSchema: options.answers?.outputSchema || previous.outputSchema || {},
+    architecturalInvariants: normalizeList(options.answers?.architecturalInvariants || previous.architecturalInvariants || ""),
+    pipeline: normalizeList(options.answers?.pipeline || previous.pipeline || ""),
+    templates: normalizeList(options.answers?.templates || previous.templates || ""),
+    versionControl: options.answers?.versionControl || previous.versionControl || {
+      remote: false,
+      provider: "",
+      developmentBranch: context.branches.development || "develop",
+      releaseBranch: context.branches.publish || "master",
+    },
+    deployment: options.answers?.deployment || previous.deployment || {
+      mode: "",
+      target: "",
+      smokeCommand: "",
+    },
+    availableArtifacts: Array.isArray(previousDiscovery.availableArtifacts) ? previousDiscovery.availableArtifacts : [],
+  };
 
   const answers = { ...defaults };
 
@@ -661,6 +683,17 @@ function buildDirectIntakeTemplate(profile) {
     architecturalInvariants: normalizeList(profile.discovery?.architecturalInvariants || []),
     pipeline: normalizeList(profile.discovery?.pipeline || []),
     templates: normalizeList(profile.discovery?.templates || []),
+    versionControl: profile.discovery?.versionControl || {
+      remote: false,
+      provider: "",
+      developmentBranch: "",
+      releaseBranch: "",
+    },
+    deployment: profile.discovery?.deployment || {
+      mode: "",
+      target: "",
+      smokeCommand: "",
+    },
   };
 }
 
@@ -715,6 +748,8 @@ function ensureDirectBootstrapArtifacts(context, profile) {
       inputSchema: intake.inputSchema || profile.discovery?.inputSchema || {},
       outputSchema: intake.outputSchema || profile.discovery?.outputSchema || {},
       decisionOwnership: intake.decisionOwnership || profile.discovery?.decisionOwnership || profile.decisionOwnership || null,
+      versionControl: intake.versionControl || profile.discovery?.versionControl || null,
+      deployment: intake.deployment || profile.discovery?.deployment || null,
     },
   };
   const qualityReport = buildQualityReport(context, mergedProfile, specText);
@@ -816,23 +851,25 @@ function buildOperatingContract(control, profile, qualityReport, context) {
       sourceArtifacts: discovery.availableArtifacts || [],
       repoScan: profile.inference || {},
     },
-    system: {
-      sourceOfTruth: discovery.sourceOfTruth || "",
-      externalServices: discovery.externalServices || [],
-      inputSchema: discovery.inputSchema || {},
-      outputSchema: discovery.outputSchema || {},
-      behaviorRules: discovery.behaviorRules || [],
-      architecturalInvariants: discovery.architecturalInvariants || [],
-    },
-    execution: {
-      pipeline: discovery.pipeline || [],
-      templates: discovery.templates || [],
-      phaseModel: "opera-v3",
-      taskSeeds: buildSeedTasks(control, profile).map((task) => task.id),
-    },
-    governance: {
-      policyFile: policyRelativePath(context),
-      riskProfile: "standard",
+    system: {
+      sourceOfTruth: discovery.sourceOfTruth || "",
+      externalServices: discovery.externalServices || [],
+      inputSchema: discovery.inputSchema || {},
+      outputSchema: discovery.outputSchema || {},
+      behaviorRules: discovery.behaviorRules || [],
+      architecturalInvariants: discovery.architecturalInvariants || [],
+    },
+    execution: {
+      pipeline: discovery.pipeline || [],
+      templates: discovery.templates || [],
+      deployment: discovery.deployment || null,
+      phaseModel: "opera-v3",
+      taskSeeds: buildSeedTasks(control, profile).map((task) => task.id),
+    },
+    governance: {
+      policyFile: policyRelativePath(context),
+      versionControl: discovery.versionControl || null,
+      riskProfile: "standard",
       approvalRules: [
         "destructive_changes_require_approval",
         "production_deploy_requires_approval",
@@ -1216,11 +1253,13 @@ function resumeBootstrap(root, control) {
     externalServices: normalizeList(intake.externalServices || bootstrap.discovery?.externalServices || []),
     behaviorRules: normalizeList(intake.behaviorRules || bootstrap.discovery?.behaviorRules || []),
     architecturalInvariants: normalizeList(intake.architecturalInvariants || bootstrap.discovery?.architecturalInvariants || []),
-    pipeline: normalizeList(intake.pipeline || bootstrap.discovery?.pipeline || []),
-    templates: normalizeList(intake.templates || bootstrap.discovery?.templates || []),
-    inputSchema: intake.inputSchema || bootstrap.discovery?.inputSchema || {},
-    outputSchema: intake.outputSchema || bootstrap.discovery?.outputSchema || {},
-  };
+    pipeline: normalizeList(intake.pipeline || bootstrap.discovery?.pipeline || []),
+    templates: normalizeList(intake.templates || bootstrap.discovery?.templates || []),
+    inputSchema: intake.inputSchema || bootstrap.discovery?.inputSchema || {},
+    outputSchema: intake.outputSchema || bootstrap.discovery?.outputSchema || {},
+    versionControl: intake.versionControl || bootstrap.discovery?.versionControl || null,
+    deployment: intake.deployment || bootstrap.discovery?.deployment || null,
+  };
   const missingFields = directMissingFields(discovery);
   const profile = {
     ...bootstrap,
@@ -1235,12 +1274,13 @@ function resumeBootstrap(root, control) {
     discovery,
     inference: scanProject(context),
   };
-  const qualityReport = buildQualityReport(context, profile, specDossier);
-  profile.status = qualityReport.status === "ready" ? "completed" : qualityReport.status;
-  profile.completedAt = qualityReport.status === "ready" ? nowIso() : null;
-  profile.qualityReport = qualityReport;
-  return { resumed: true, profile };
-}
+  const qualityReport = buildQualityReport(context, profile, specDossier);
+  profile.status = qualityReport.status === "ready" ? "completed" : qualityReport.status;
+  profile.completedAt = qualityReport.status === "ready" ? nowIso() : null;
+  profile.missingFields = qualityReport.missingFields || [];
+  profile.qualityReport = qualityReport;
+  return { resumed: true, profile };
+}
 
 function detectLegacyBootstrap(root, control) {
   const context = config.ensureContext(root);