amsd-pipeline-workflow 0.1.14 → 0.1.16

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

@@ -48,7 +48,7 @@ async function runReleaseLines(ctx, lane, clPrd, laneLog, laneEnv, canonical, ph
         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);
       }
-      const done = fs.existsSync(linePrd) && (() => { const p = JSON.parse(fs.readFileSync(linePrd, 'utf8')); return p.stories.length > 0 && p.stories.every((s) => s.status === 'completed'); })();
+      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 = [];
@@ -104,6 +104,20 @@ function completeLineByCommit(env, wt, lineLog, linePrd, branch, log) {
   if (git(wt, 'rev-parse', '--verify', '--quiet', branch).status !== 0) return;
   if (git(wt, 'checkout', '-q', branch).status !== 0) { log(`[orch] could not check out ${branch} to read its committed work`); return; }
   bash({ ...env, PROJECT_ROOT: wt }, 'story_resume_completed_by_commit', [wt, lineLog, linePrd], { log });
+  // THE PIPELINE'S FUNCTION SETS completed ONLY; the line's done test reads status (lib/release-lines.sh:96), so a line
+  // completed by its commit read as not done, took the --reset path and was rewritten (LIVE-AMSD-2974-11, 2026-10-20).
+  // A Writer-completed story carries both; this one does too.
+  const p = JSON.parse(fs.readFileSync(linePrd, 'utf8'));
+  let changed = false;
+  for (const s of p.stories || []) if (s.completed === true && s.status !== 'completed' && s.status !== 'deprecated') { s.status = 'completed'; changed = true; }
+  if (changed) fs.writeFileSync(linePrd, JSON.stringify(p, null, 2));
 }
 
-module.exports = { runReleaseLines, completeLineByCommit };
+/** A line whose every story is completed — the pipeline's own test (lib/release-lines.sh:96). */
+function lineIsDone(linePrd) {
+  if (!fs.existsSync(linePrd)) return false;
+  const p = JSON.parse(fs.readFileSync(linePrd, 'utf8'));
+  return (p.stories || []).length > 0 && p.stories.every((s) => s.status === 'completed');
+}
+
+module.exports = { runReleaseLines, completeLineByCommit, lineIsDone };

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.14",
+  "version": "0.1.16",
   "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",