hadara 0.3.3 → 0.3.4-rc.0

package/dist/services/capability-registry.js

@@ -597,6 +597,29 @@ exports.HADARA_COMMAND_REGISTRY = [
         related: ['evidence.add-command', 'evidence.lint'],
         conflictsWith: []
     },
+    {
+        id: 'evidence.summary',
+        command: 'hadara evidence summary --task <task-id> [--limit <n>] [--include-private] [--json]',
+        summary: 'Show compact evidence ids, latest evidence, and latest close evidence for copy/paste into docs and resolution markers.',
+        canonical: true,
+        appearsInDefaultHelp: false,
+        family: 'capsule-lifecycle',
+        scope: 'evidence',
+        lifecycleStage: 'evidence',
+        requiredness: 'conditional',
+        writeBoundary: 'read-only',
+        readOnly: true,
+        risk: 'low',
+        actor: 'agent-worker',
+        status: 'stable',
+        schemaVersion: 'hadara.evidence.summary.v1',
+        docs: ['docs/IMPLEMENTATION_SOP.md', 'docs/specs/0.3.4/agent-ux/00_Agent_UX_Hardening_Spec.md'],
+        implementationFiles: ['src/cli/evidence.ts', 'src/services/evidence-summary.ts'],
+        testFiles: ['tests/unit/evidence-summary.test.ts', 'tests/unit/evidence-json.test.ts'],
+        examples: [example('Copy latest close evidence id', 'hadara evidence summary --task T-0001 --json', 'After finalize or close evidence append.')],
+        related: ['evidence.list', 'evidence.add-command', 'task.finalize'],
+        conflictsWith: []
+    },
     {
         id: 'evidence.lint',
         command: 'hadara evidence lint --task <task-id> [--json]',
@@ -1253,6 +1276,27 @@ exports.HADARA_COMMAND_REGISTRY = [
         related: ['handoff.update'],
         conflictsWith: []
     }),
+    commandEntry({
+        id: 'handoff.stale-problems',
+        command: 'hadara handoff stale-problems [--json]',
+        summary: 'Report advisory stale candidates in `docs/AGENT_HANDOFF.md` Current Known Problems.',
+        canonical: true,
+        appearsInDefaultHelp: false,
+        family: 'capsule-lifecycle',
+        scope: 'docs',
+        lifecycleStage: 'handoff',
+        requiredness: 'conditional',
+        writeBoundary: 'read-only',
+        readOnly: true,
+        risk: 'low',
+        actor: 'agent-worker',
+        status: 'stable',
+        schemaVersion: 'hadara.handoff.staleProblems.v1',
+        docs: ['docs/AGENT_HANDOFF.md'],
+        examples: [example('Find stale known problems', 'hadara handoff stale-problems --json', 'When reviewing whether handoff known-problem rows were resolved by later tasks or releases.')],
+        related: ['handoff.suggest', 'handoff.update', 'task.audit-close'],
+        conflictsWith: []
+    }),
     commandEntry({
         id: 'write.preflight',
         command: 'hadara write preflight <command...> [--json]',
@@ -1641,6 +1685,56 @@ exports.HADARA_COMMAND_REGISTRY = [
             }
         ]
     }),
+    commandEntry({
+        id: 'package.recycle',
+        command: 'hadara package recycle [--execute] [--package <specifier>] [--expected-version <version>] [--json]',
+        summary: 'Preview or execute installed-package recycle validation from the package registry.',
+        canonical: true,
+        appearsInDefaultHelp: false,
+        family: 'release-package',
+        scope: 'package',
+        lifecycleStage: 'ready',
+        requiredness: 'release-only',
+        writeBoundary: 'external-subprocess',
+        readOnly: false,
+        risk: 'medium',
+        actor: 'release-operator',
+        status: 'stable',
+        schemaVersion: 'hadara.packageRecycle.v1',
+        implementationFiles: ['src/cli/package-smoke.ts', 'src/services/package-recycle.ts'],
+        testFiles: ['tests/unit/package-recycle.test.ts'],
+        docs: ['docs/RELEASE_READINESS.md', 'docs/CLI_JSON_CONTRACT.md'],
+        examples: [
+            example('Preview installed-package recycle', 'hadara package recycle --package hadara@latest --expected-version 0.3.3 --json', 'Before running registry-backed consumer install validation.'),
+            example('Execute installed-package recycle', 'hadara package recycle --execute --package hadara@latest --expected-version 0.3.3 --task T-XXXX --attach-evidence --json', 'After an npm publish when verifying consumer install paths.')
+        ],
+        related: ['package.smoke', 'release.closeout', 'release.publish'],
+        conflictsWith: [],
+        capabilitySurfaces: [
+            {
+                name: 'hadara package recycle --json',
+                category: 'read',
+                stable: true,
+                readOnly: true,
+                enabledByDefault: true,
+                availability: 'default',
+                risk: 'low',
+                schemaVersion: 'hadara.packageRecycle.v1',
+                notes: 'Read-only installed-package recycle dry-run planner.'
+            },
+            {
+                name: 'hadara package recycle --execute --json',
+                category: 'execute',
+                stable: true,
+                readOnly: false,
+                enabledByDefault: true,
+                availability: 'default',
+                risk: 'medium',
+                schemaVersion: 'hadara.packageRecycle.v1',
+                notes: 'Explicit npm registry and isolated-prefix consumer package validation.'
+            }
+        ]
+    }),
     commandEntry({
         id: 'release.dry-run',
         command: 'hadara release dry-run [--json]',
@@ -1664,6 +1758,27 @@ exports.HADARA_COMMAND_REGISTRY = [
         related: ['release.gate', 'release.publish', 'release.artifact'],
         conflictsWith: []
     }),
+    commandEntry({
+        id: 'release.closeout',
+        command: 'hadara release closeout --version <version> --task <task-id> [--json]',
+        summary: 'Plan release closeout document updates without writing files.',
+        canonical: true,
+        appearsInDefaultHelp: false,
+        family: 'release-package',
+        scope: 'release',
+        lifecycleStage: 'ready',
+        requiredness: 'release-only',
+        writeBoundary: 'read-only',
+        readOnly: true,
+        risk: 'low',
+        actor: 'release-operator',
+        status: 'stable',
+        schemaVersion: 'hadara.releaseCloseout.v1',
+        docs: ['docs/RELEASE_READINESS.md', 'docs/RELEASE_NOTES.md', 'docs/PROJECT_STATE.md', 'docs/AGENT_HANDOFF.md'],
+        examples: [example('Plan release closeout', 'hadara release closeout --version 0.3.4 --task T-0418 --json', 'After publish/recycle work when aligning release state docs.')],
+        related: ['release.dry-run', 'release.publish', 'release.gate'],
+        conflictsWith: []
+    }),
     commandEntry({
         id: 'release.publish',
         command: 'hadara release publish [--mode dry-run|execute] [--json]',

package/dist/services/dashboard-bootstrap.js

@@ -9,7 +9,7 @@ const task_read_model_1 = require("./task-read-model");
 const task_workbench_1 = require("./task-workbench");
 function createDashboardBootstrapReport(projectRoot, input = {}, now = new Date()) {
     const generatedAt = now.toISOString();
-    const core = input.tier === 'core';
+    const core = input.tier !== 'full';
     const status = (0, operations_status_service_1.createOpsStatusReport)(projectRoot, { includeDebt: !core });
     const tasks = (0, task_read_model_1.createTaskListReport)(projectRoot);
     // Reuse the already-computed status/tasks so the timeline does not re-run the
@@ -34,8 +34,8 @@ function createDashboardBootstrapReport(projectRoot, input = {}, now = new Date(
             project: (0, dashboard_cache_1.createDashboardProjectReference)(projectRoot)
         },
         cache: (0, dashboard_cache_1.disabledDashboardCacheMetadata)(selectedTaskId
-            ? (0, dashboard_cache_1.createDashboardCacheKey)(projectRoot, 'bootstrap', 'selected', selectedTaskId)
-            : (0, dashboard_cache_1.createDashboardCacheKey)(projectRoot, 'bootstrap'), generatedAt),
+            ? (0, dashboard_cache_1.createDashboardCacheKey)(projectRoot, 'bootstrap', core ? 'core' : 'full', 'selected', selectedTaskId)
+            : (0, dashboard_cache_1.createDashboardCacheKey)(projectRoot, 'bootstrap', core ? 'core' : 'full'), generatedAt),
         tier: core ? 'core' : 'full',
         status,
         taskSummary: {

package/dist/services/evidence-summary.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEvidenceSummaryReport = createEvidenceSummaryReport;
+const evidence_list_1 = require("./evidence-list");
+function createEvidenceSummaryReport(projectRoot, input) {
+    const list = (0, evidence_list_1.createEvidenceListReport)(projectRoot, {
+        taskId: input.taskId,
+        limit: input.limit,
+        includePrivate: input.includePrivate
+    });
+    const records = list.records.map(toSummaryRecord);
+    const latest = latestByTime(records);
+    const latestCloseEvidence = latestByTime(records.filter(isCloseEvidence));
+    const durableIds = records.filter((record) => record.idStability === 'durable').map((record) => record.id);
+    return {
+        schemaVersion: 'hadara.evidence.summary.v1',
+        command: 'evidence.summary',
+        ok: list.ok,
+        readOnly: true,
+        taskId: input.taskId,
+        summary: {
+            count: records.length,
+            durableCount: durableIds.length,
+            unstableCount: records.length - durableIds.length,
+            privateIncluded: input.includePrivate === true,
+            latestId: latest?.id ?? null,
+            latestCloseEvidenceId: latestCloseEvidence?.id ?? null
+        },
+        records,
+        latest,
+        latestCloseEvidence,
+        copyHints: {
+            latestId: latest?.id ?? null,
+            latestCloseEvidenceId: latestCloseEvidence?.id ?? null,
+            durableIds
+        },
+        issues: list.issues
+    };
+}
+function toSummaryRecord(record) {
+    return {
+        id: record.id,
+        time: record.time,
+        category: record.category,
+        outcome: record.outcome,
+        visibility: record.visibility,
+        summary: record.summary,
+        tags: record.tags,
+        sourceLine: record.sourceLine,
+        idSource: record.idSource,
+        idStability: record.idStability,
+        persistedSchemaVersion: record.persistedSchemaVersion
+    };
+}
+function latestByTime(records) {
+    if (records.length === 0)
+        return null;
+    return records.reduce((latest, record) => (record.time >= latest.time ? record : latest), records[0]);
+}
+function isCloseEvidence(record) {
+    if (record.tags.includes('close-proof'))
+        return true;
+    if (record.category === 'audit' && /close/i.test(record.summary))
+        return true;
+    return false;
+}