hadara 0.2.0-rc.0 → 0.2.0-rc.1

package/README.md

@@ -5,7 +5,7 @@
 </p>
 
 <p align="center">
-  <img alt="Release candidate" src="https://img.shields.io/badge/release-0.2.0--rc.0-blue">
+  <img alt="Release candidate" src="https://img.shields.io/badge/release-0.2.0--rc.1-blue">
   <img alt="Node.js" src="https://img.shields.io/badge/node-%3E%3D22-brightgreen">
   <img alt="License" src="https://img.shields.io/badge/license-MIT-lightgrey">
 </p>
@@ -23,10 +23,10 @@ This repository is both the HADARA source checkout and the HADARA protocol works
 The current source checkout targets:
 
 ```text
-hadara@0.2.0-rc.0
+hadara@0.2.0-rc.1
 ```
 
-T-0268 refreshed package smoke, clean-checkout smoke, release artifact, release dry-run, and publish dry-run evidence for `0.2.0-rc.0`. T-0269 is the approval-gated publish capsule for this RC.
+T-0275 refreshes package smoke, clean-checkout smoke, release artifact, release dry-run, and publish dry-run evidence for `0.2.0-rc.1`. T-0269 prepared the previous `0.2.0-rc.0` publish path, but rc.1 supersedes it after the installed-package recycle fixes.
 
 Current publish boundaries:
 
@@ -34,7 +34,8 @@ Current publish boundaries:
 |---|---|
 | npm package | Primary release target. |
 | `hadara@0.1.0-rc.0` | Published first RC. |
-| `hadara@0.2.0-rc.0` | Current source and publish-candidate version. |
+| `hadara@0.2.0-rc.0` | Superseded internal publish candidate after recycle findings. |
+| `hadara@0.2.0-rc.1` | Current source and publish-candidate version. |
 | GitHub Release | Secondary target, still approval-gated. |
 | Docker image | Deferred. |
 | PyPI/Python package | Advisory preview only. |
@@ -49,7 +50,7 @@ Requires Node.js 22.
 Install the current RC:
 
 ```bash
-npm install -g hadara@0.2.0-rc.0
+npm install -g hadara@0.2.0-rc.1
 hadara doctor --json
 hadara task list --json
 hadara tools list --json
@@ -58,11 +59,11 @@ hadara tools list --json
 Run without a global install:
 
 ```bash
-npx hadara@0.2.0-rc.0 doctor --json
-npx hadara@0.2.0-rc.0 tools list --json
+npx hadara@0.2.0-rc.1 doctor --json
+npx hadara@0.2.0-rc.1 tools list --json
 ```
 
-Previous RC: `hadara@0.1.0-rc.0` remains available on npm for comparison or rollback, but new installs should use the current RC once it is published.
+Previous published RC: `hadara@0.1.0-rc.0` remains available on npm for comparison or rollback, but new installs should use the current RC once it is published.
 
 ## What HADARA Gives You
 

package/dist/cli/doctor.js

@@ -11,7 +11,7 @@ function createDoctorReport(paths, nodeVersion = process.version) {
     const checks = [
         pathCheck('docs', paths.projectDocsDir),
         pathCheck('tasks', paths.projectTasksDir),
-        pathCheck('project-context', paths.projectHadaraDir)
+        pathCheck('project-context', `${paths.projectContextDir}/HADARA_CONTEXT.md`)
     ];
     return {
         schemaVersion: 'hadara.doctor.v1',
@@ -63,6 +63,6 @@ function formatCheckLabel(id) {
     if (id === 'tasks')
         return 'tasks/:      ';
     if (id === 'project-context')
-        return '.hadara/:    ';
+        return '.hadara/context/HADARA_CONTEXT.md: ';
     return `${id}: `;
 }

package/dist/cli/handoff.js

@@ -27,7 +27,12 @@ function handleHandoffCommand(input) {
     const taskId = (0, args_1.getStringOption)(input.args, '--task');
     const summary = (0, args_1.getStringOption)(input.args, '--summary');
     const nextStep = (0, args_1.getStringOption)(input.args, '--next');
-    const filePath = (0, handoff_1.updateHandoff)({ projectRoot: input.projectRoot, taskId, summary, nextStep });
-    console.log(`[HADARA] Handoff updated: ${filePath}`);
+    const report = (0, handoff_1.updateHandoff)({ projectRoot: input.projectRoot, taskId, summary, nextStep });
+    if (input.jsonOutput) {
+        console.log(JSON.stringify(report, null, 2));
+    }
+    else {
+        console.log(`[HADARA] Handoff updated: ${report.target.path}`);
+    }
     return true;
 }

package/dist/cli/init.js

@@ -58,17 +58,37 @@ const INIT_PROFILE_SPECS = {
         }
     }
 };
-function initProject(projectRoot, profile = 'standard') {
+function initProject(projectRoot, profile = 'standard', options = {}) {
     const normalizedProfile = parseInitProfile(profile);
     const spec = INIT_PROFILE_SPECS[normalizedProfile];
     const paths = (0, paths_1.resolveHadaraPaths)({ projectRoot });
     (0, fs_1.ensureDir)(paths.projectDocsDir);
     (0, fs_1.ensureDir)(paths.projectTasksDir);
+    const actions = [];
     for (const file of createGeneratedScaffoldFiles(normalizedProfile)) {
+        const absolutePath = node_path_1.default.join(projectRoot, file.path);
+        const existed = node_fs_1.default.existsSync(absolutePath);
         (0, fs_1.writeFileIfMissing)(node_path_1.default.join(projectRoot, file.path), file.content);
+        actions.push({
+            action: 'init-doc',
+            path: file.path,
+            status: existed ? 'exists' : 'created',
+            summary: existed ? `${file.path} already existed and was not overwritten.` : `${file.path} was created.`
+        });
+    }
+    const report = {
+        schemaVersion: 'hadara.init.v1',
+        command: 'init',
+        ok: true,
+        profile: normalizedProfile,
+        actions,
+        issues: []
+    };
+    if (!options.silent) {
+        console.log(`[HADARA] Initialized project: ${projectRoot}`);
+        console.log(`[HADARA] Init profile: ${normalizedProfile}`);
     }
-    console.log(`[HADARA] Initialized project: ${projectRoot}`);
-    console.log(`[HADARA] Init profile: ${normalizedProfile}`);
+    return report;
 }
 function parseInitProfile(value) {
     if (value === 'basic' || value === 'standard' || value === 'governed')
@@ -106,7 +126,9 @@ function handleInitCommand(input) {
         printInitFollowUpReport(report, input.jsonOutput);
         return true;
     }
-    initProject(input.projectRoot, (0, args_1.getStringOption)(input.args, '--profile', 'standard') ?? 'standard');
+    const report = initProject(input.projectRoot, (0, args_1.getStringOption)(input.args, '--profile', 'standard') ?? 'standard', { silent: input.jsonOutput });
+    if (input.jsonOutput)
+        console.log(JSON.stringify(report, null, 2));
     return true;
 }
 function getInitFollowUpMode(args) {
@@ -160,7 +182,7 @@ function createInitDoctorReport(projectRoot) {
         issues.push({ severity: 'warning', code: 'INIT_BROAD_DATA_IGNORE', path: '.gitignore', message: 'Top-level data/ is ignored; generated init should only ignore HADARA local/private state.' });
     }
     const sop = readProjectText(projectRoot, 'docs/IMPLEMENTATION_SOP.md');
-    if (sop !== null && /minimal|full|hadara-protocol/.test(sop)) {
+    if (sop !== null && mentionsLegacyInitProfile(sop)) {
         issues.push({ severity: 'warning', code: 'INIT_OLD_PROFILE_NAME', path: 'docs/IMPLEMENTATION_SOP.md', message: 'SOP mentions old init profile names.' });
     }
     issues.push(...detectProfileMetadataMismatches(projectRoot));
@@ -185,6 +207,9 @@ function createInitDoctorReport(projectRoot) {
         issues
     };
 }
+function mentionsLegacyInitProfile(content) {
+    return /(?:initialized with|profile(?:\s+name)?|init profile)\s+(?:the\s+)?`?(minimal|full|hadara-protocol)`?/i.test(content);
+}
 function createInitUpgradeReport(projectRoot, profile, mode) {
     const actions = [];
     const issues = [];

package/dist/cli/main.js

@@ -41,7 +41,7 @@ function printHelp() {
     console.log(`HADARA bootstrap CLI
 
 Usage:
-  hadara init [--project <path>] [--profile basic|standard|governed]
+  hadara init [--project <path>] [--profile basic|standard|governed] [--json]
   hadara init doctor [--json]
   hadara init upgrade --profile basic|standard|governed [--execute] [--json]
   hadara init register-doc --path <path> --when <text> --purpose <text> [--require-exists] [--execute] [--json]
@@ -73,7 +73,7 @@ Usage:
   hadara protocol doctor --scope docs|profile|all [--json]
   hadara protocol remediate --fix task-board-row|decisions-table-frame|project-state-profile|evidence-jsonl [--task <task-id>] [--profile basic|standard|governed] [--execute --before-hash <hash>] [--json]
   hadara tools list [--json]
-  hadara handoff update --task <task-id> [--summary <text>] [--next <text>]
+  hadara handoff update --task <task-id> [--summary <text>] [--next <text>] [--json]
   hadara handoff suggest --task <task-id> [--json]
   hadara write preflight <command...> [--json]
   hadara policy check-shell <command> [--mode readonly|assisted|trusted|auto|release]

package/dist/cli/run-scaffold.js

@@ -21,7 +21,7 @@ function scaffoldRunScenario(projectRoot, input) {
             finishReason: 'tool_call'
         },
         {
-            match: input.stdout,
+            match: '"status":"completed"',
             response: `Scaffolded fake-shell command completed: ${input.command}`
         }
     ];

package/dist/dev/docker-check.js

@@ -60,8 +60,10 @@ function createDevDockerCheckReport(projectRoot, options = {}, runner = defaultR
             issues.push({
                 severity: 'error',
                 code: 'DEV_DOCKER_CHECK_STEP_FAILED',
-                message: `Docker validation step failed: ${step.id}. Raw subprocess logs are intentionally omitted from the JSON report.`,
-                stepId: step.id
+                message: `Docker validation step failed: ${step.id}${typeof result.exitCode === 'number' ? ` (exit code ${result.exitCode})` : ''}. Raw subprocess logs are intentionally omitted from the JSON report.`,
+                stepId: step.id,
+                ...(typeof result.exitCode === 'number' ? { exitCode: result.exitCode } : {}),
+                debugHint: `Rerun dev docker-check without --json, or inspect the Docker container step ${step.id}; JSON reports keep subprocess logs private.`
             });
             blocked = true;
         }
@@ -125,7 +127,7 @@ function formatDevDockerCheckReport(report) {
     for (const step of report.steps)
         lines.push(`${step.status}\t${step.id}\t${step.summary}`);
     for (const issue of report.issues)
-        lines.push(`[${issue.severity}] ${issue.code}: ${issue.message}`);
+        lines.push(`[${issue.severity}] ${issue.code}: ${issue.message}${typeof issue.exitCode === 'number' ? ` exitCode=${issue.exitCode}` : ''}`);
     return lines.join('\n');
 }
 function buildSteps(focusedTests, runFullCheck, syncDistRequested, syncDistAllowed) {

package/dist/handoff/handoff-suggestion.js

@@ -73,7 +73,7 @@ function readTaskSnapshot(projectRoot, taskId, issues) {
 function createSections(task, targetBeforeHash, executeRequested) {
     const displayName = [task.taskId, task.title].filter(Boolean).join(' ');
     const evidence = task.evidenceSummary ?? 'Review task evidence and validation records.';
-    const nextTask = executeRequested ? 'Remove --execute and review this suggestion report.' : 'Run `hadara task next --json` and create the next Phase 6 capsule.';
+    const nextTask = executeRequested ? 'Remove --execute and review this suggestion report.' : 'Run `hadara task next --json` and create or select the next capsule.';
     return [
         section({
             id: 'current-state',
@@ -108,7 +108,7 @@ function createSections(task, targetBeforeHash, executeRequested) {
             action: 'replace-row',
             summary: 'Point the next step at task discovery rather than applying this report automatically.',
             targetBeforeHash,
-            suggestedReplacementMarkdown: `| Select the next task with \`hadara task next --json\`. | Continue Phase 6 in order after ${task.taskId}. | Required reading: Phase 6 spec, \`docs/CLI_JSON_CONTRACT.md\`, \`docs/TASK_WORKFLOW_COMMANDS.md\`. |`
+            suggestedReplacementMarkdown: `| Select the next task with \`hadara task next --json\`. | Continue project work after ${task.taskId} using the current Task Board and handoff. | Required reading: \`docs/AGENT_HANDOFF.md\`, \`docs/TASK_BOARD.md\`, and \`docs/TASK_WORKFLOW_COMMANDS.md\`. |`
         }),
         section({
             id: 'validation-baseline',

package/dist/handoff/handoff.js

@@ -45,5 +45,19 @@ ${input.nextStep ?? 'Read PROJECT_STATE.md, TASK_BOARD.md, and the active Task C
 Attach test logs, command outputs, and diff summaries under the active Task Capsule.
 `;
     node_fs_1.default.writeFileSync(filePath, content, 'utf8');
-    return filePath;
+    return {
+        schemaVersion: 'hadara.handoff.update.v1',
+        command: 'handoff.update',
+        ok: true,
+        target: {
+            path: 'docs/AGENT_HANDOFF.md',
+            writeBoundary: 'shared-doc'
+        },
+        input: {
+            taskId: input.taskId ?? null,
+            summaryProvided: typeof input.summary === 'string',
+            nextStepProvided: typeof input.nextStep === 'string'
+        },
+        issues: []
+    };
 }

package/dist/schemas/dev-docker-check.schema.json

@@ -111,6 +111,20 @@
                 "environmentSecretsIncluded": { "const": false }
             }
         },
-        "issues": { "type": "array", "items": { "type": "object", "additionalProperties": true } }
+        "issues": {
+            "type": "array",
+            "items": {
+                "type": "object",
+                "additionalProperties": true,
+                "properties": {
+                    "severity": { "enum": ["error", "warning", "info"] },
+                    "code": { "type": "string" },
+                    "message": { "type": "string" },
+                    "stepId": { "type": "string" },
+                    "exitCode": { "type": "number" },
+                    "debugHint": { "type": "string" }
+                }
+            }
+        }
     }
 }

package/dist/schemas/task-workbench.schema.json

@@ -29,6 +29,7 @@
             }
         ],
         "additive": [
+            "state.readiness",
             "sources.*",
             "nextActions.*"
         ],
@@ -67,6 +68,17 @@
             "properties": {
                 "closeState": { "enum": ["not-closed", "closed", "closed-valid", "close-evidence-found-invalid", "close-evidence-malformed"] },
                 "ready": { "type": "boolean" },
+                "readiness": {
+                    "type": "object",
+                    "additionalProperties": true,
+                    "required": ["status", "currentReady", "closeProofValid", "summary"],
+                    "properties": {
+                        "status": { "enum": ["ready", "current-blocked", "closed-valid-current-blocked", "missing-task"] },
+                        "currentReady": { "type": "boolean" },
+                        "closeProofValid": { "type": "boolean" },
+                        "summary": { "type": "string" }
+                    }
+                },
                 "closeEvidenceFound": { "type": "boolean" },
                 "closedValid": { "type": "boolean" },
                 "closed": { "type": "boolean" },