amsd-pipeline-workflow 0.1.15 → 0.1.17

package/doctor/profile.json

@@ -0,0 +1,112 @@
+{
+  "component": {
+    "name": "amsd-pipeline-workflow",
+    "package": "amsd-pipeline-workflow",
+    "description": "the AMSD pipeline as Claude workflows: the driver, the workflow generators, the hooks and the launch tools"
+  },
+  "scope": {
+    "repairDirs": [
+      "driver",
+      "generator",
+      "hooks",
+      "mcp"
+    ],
+    "testDirs": [
+      "test"
+    ],
+    "testFile": "^test/.*\\.test\\.js$",
+    "forbiddenTests": [
+      "(^|/)driver-[^/]*\\.test\\.js$"
+    ]
+  },
+  "test": {
+    "command": [
+      "{node}",
+      "--test",
+      "{files}"
+    ],
+    "envUnset": [
+      "NODE_TEST_CONTEXT"
+    ],
+    "greenPatterns": [
+      "ℹ pass [1-9]",
+      "ℹ fail 0",
+      "✔ (?!\\S+\\.js \\()"
+    ],
+    "failedPattern": "ℹ fail [1-9]"
+  },
+  "install": {
+    "dest": "claude-workflows",
+    "requires": [
+      "orchestrations/scripts",
+      "orchestrations/projects"
+    ],
+    "command": [
+      "{node}",
+      "{worktree}/bin/amsd-pipeline-workflow.js",
+      "install",
+      "--into",
+      "{install}"
+    ],
+    "manifest": "package.json#files",
+    "patchRecord": "doctor-patches.json"
+  },
+  "crash": {
+    "file": "crash.json"
+  },
+  "classify": {
+    "runtime": "node",
+    "refusals": [
+      "never works a real codeline",
+      "cannot resume run",
+      "operator's yes",
+      "needs the operator"
+    ]
+  },
+  "settings": {
+    "on": "EPAM_PIPELINE_DOCTOR",
+    "restarts": "EPAM_PIPELINE_DOCTOR_RESTARTS",
+    "repo": "EPAM_PIPELINE_DOCTOR_REPO",
+    "budget": "EPAM_PIPELINE_DOCTOR_BUDGET_USD"
+  },
+  "restart": {
+    "args": [
+      "--resume"
+    ]
+  },
+  "model": {
+    "family": "sonnet",
+    "config": "{install}/orchestrations/config/llm-defaults.claude.json"
+  },
+  "logs": {
+    "dir": "doctor",
+    "alerts": "abort-alerts.log",
+    "evidence": [
+      "driver.log"
+    ],
+    "evidenceTailLines": 200
+  },
+  "branch": {
+    "prefix": "doctor/"
+  },
+  "boundaries": [
+    "the ticket (any AMSD-… story) and its Jira content",
+    "every client repository and every codeline copy the run works in (cx-shared, gotransit, metrolinx, upexpress and any other)",
+    "the bash pipeline (the install's orchestrations/ folder) — a defect there is reported, never repaired",
+    "package.json, bin/, docs/ and everything outside the repairable directories",
+    "the pipeline's own prompt templates, agent roster, seams, ladders and system instructions in the install's orchestrations/ folder (the generators' prompts in generator/ are the agentic layer the doctor may repair)"
+  ],
+  "agentic": {
+    "dirs": [
+      "generator",
+      "hooks"
+    ],
+    "abortSignatures": [
+      "session's answer is not JSON",
+      "the detective gave none",
+      "the step runner gave no result"
+    ],
+    "autoApply": true,
+    "description": "the workflow generators' prompts, system instructions and answer schemas (generator/), and the hooks that hand one agent's result to the next (hooks/)"
+  }
+}

package/driver/release-lines.js

@@ -46,13 +46,13 @@ async function runReleaseLines(ctx, lane, clPrd, laneLog, laneEnv, canonical, ph
       // A RESUMED LINE'S COMMITTED WORK IS NOT REWRITTEN (operator, 2026-10-20): its story completed by its commit, as a lane's is
       if (env.EPAM_RESUME_RUN && fs.existsSync(linePrd)) {
         const id = (JSON.parse(fs.readFileSync(linePrd, 'utf8')).stories[0] || {}).id;
-        if (id) completeLineByCommit(env, wt, lineLog, linePrd, `${env.EPAM_BRANCH_PREFIX || ''}AI-${id}-${slug}`, log);
+        if (id) completeLineByCommit(env, wt, lineLog, linePrd, lineBranch(env, id, slug), log);
       }
       const done = lineIsDone(linePrd);
       if (bash(env, 'resume_preserves', ['completed-stories']).status === 0 && done
         && !handler(env, 'spec-predates-plan', [linePrd, canonical || clPrd]).stdout.trim()) {        // :96–106
         rerun = [];
-        const lb = `${env.EPAM_BRANCH_PREFIX || ''}AI-${JSON.parse(fs.readFileSync(linePrd, 'utf8')).stories[0].id}-${slug}`;
+        const lb = lineBranch(env, JSON.parse(fs.readFileSync(linePrd, 'utf8')).stories[0].id, slug);
         if (git(wt, 'checkout', '-q', lb).status !== 0) log(`[orch] Codeline '${cl}': could not check out ${lb} for its review`);
         handler(env, 'carry-plan', [linePrd, canonical || clPrd], { log });
         log(`[orch] Codeline '${cl}' — release line ${line} completed in this run — its reviewer judges it again against the story's plan`);
@@ -94,6 +94,16 @@ async function runReleaseLines(ctx, lane, clPrd, laneLog, laneEnv, canonical, ph
   }
 }
 
+/**
+ * A RELEASE LINE'S BRANCH NAME — the shared run-state core's ONE rule (story_branch_name, lib/git-ops.sh; backlog B75, finding RS-10), asked of the install's own
+ * function: the driver keeps no second copy of the rule. An install that predates it is said, loudly.
+ */
+function lineBranch(env, id, slug) {
+  const r = bash(env, 'story_branch_name', [id, `-${slug}`]);
+  if (r.status !== 0 || !r.stdout.trim()) throw new Error(`the install's lib/git-ops.sh has no story_branch_name (exit ${r.status}) — it needs amsd-pipeline-shared >= 0.5.2 (amsd-pipeline-shared install --into <install>)`);
+  return r.stdout.trim();
+}
+
 /**
  * A RESUMED RELEASE LINE (LIVE-AMSD-2974-11): the line's branch checked out and the pipeline's own
  * story_resume_completed_by_commit run on the line's log and PRD. The pipeline applies it to lanes only, so a line whose
@@ -120,4 +130,4 @@ function lineIsDone(linePrd) {
   return (p.stories || []).length > 0 && p.stories.every((s) => s.status === 'completed');
 }
 
-module.exports = { runReleaseLines, completeLineByCommit, lineIsDone };
+module.exports = { runReleaseLines, completeLineByCommit, lineIsDone, lineBranch };

package/driver/run.js

@@ -578,6 +578,17 @@ if (require.main === module) {
     if (r.error) { process.stderr.write(`the stand-in runtime could not drop the network (unshare -rn): ${r.error.message}\n`); process.exit(1); }
     process.exit(r.status === null ? 1 : r.status);
   }
+  // THE CRASH LISTENER is the shared component's (lib/doctor/crash-record.js), loaded from the install this driver runs against, writing the file this port's
+  // profile names: a throw nothing caught leaves that record and a `crashed` answer, and the launcher decides from it whether the failure is a defect in this
+  // code (the shared doctor's classifier). An install that predates the shared doctor is SAID, loudly — never silently unlistened.
+  const crash = (() => {
+    const f = path.join(path.resolve(a0.install || '.'), 'orchestrations', 'scripts', 'lib', 'doctor', 'crash-record.js');
+    try {
+      const lib = require(f); // eslint-disable-line global-require, import/no-dynamic-require
+      if (a0.out) lib.install({ runDir: path.resolve(a0.out), file: JSON.parse(fs.readFileSync(process.env.AMSD_DOCTOR_PROFILE || path.join(__dirname, '..', 'doctor', 'profile.json'), 'utf8')).crash.file });
+      return lib;
+    } catch (e) { process.stderr.write(`[driver] crash listener unavailable: ${e.code === 'MODULE_NOT_FOUND' ? `the install has no ${f} — it needs amsd-pipeline-shared >= 0.5.0 (amsd-pipeline-shared install --into <install>)` : e.message}\n`); return null; }
+  })();
   main(a0).then((o) => { process.stdout.write(`${JSON.stringify(o)}\n`); process.exit(o.exit || 0); })
-    .catch((e) => { process.stderr.write(`${e.stack || e.message}\n`); process.exit(1); });
+    .catch((e) => { process.stderr.write(`${e.stack || e.message}\n`); if (crash) crash.die(e); else process.exit(1); });
 }

package/generator/analyst-values.sh

@@ -39,7 +39,7 @@ while IFS= read -r _f; do
     while IFS= read -r _pkg; do
         [ -z "$_pkg" ] && continue
         _vc="$PROJECT_ROOT/.contracts/vendor-${_pkg}.md"
-        [ -f "$_vc" ] || _generate_vendor_contract "$PROJECT_ROOT" "$_pkg" 2>/dev/null
+        [ -f "$_vc" ] || _generate_vendor_contract "$PROJECT_ROOT" "$_pkg" >/dev/null 2>/dev/null
         [ -f "$_vc" ] && dependency_contracts="${dependency_contracts}
 ### Vendor package: ${_pkg}
 $(cat "$_vc")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "amsd-pipeline-workflow",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "The AMSD pipeline as Claude workflows. Installed by the amsd-pipeline installer: install.sh --workflows",
   "license": "UNLICENSED",
   "bin": {
@@ -11,6 +11,7 @@
     "driver/",
     "generator/",
     "hooks/",
+    "doctor/",
     "mcp/",
     "test/layer1/harness.js",
     "test/layer1/hook-harness.js",