sdd-agent-platform 0.4.1 → 0.5.0

package/node_modules/@sdd-agent-platform/core/dist/runtime-projection-p0.js

@@ -0,0 +1,211 @@
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { branchToSafePartition, normalizePortablePath } from './path-safety.js';
+import { hashDocumentContent } from './sdd-docs/document-hashes.js';
+import { listRuntimeProjections, readRuntimeProjectionEnvelope, recordRuntimeProjectionEnvelope, runtimeProjectionStaleness } from './storage/runtime-store.js';
+import { NEXT_INTENT_PROJECTION_TYPE, TASK_ORCHESTRATION_PROJECTION_TYPE, VALIDATION_UNIT_PROJECTION_TYPE, WORKFLOW_CURRENT_STATE_PROJECTION_TYPE } from './workflow-state/runtime-projections.js';
+import { DIAGNOSTIC_PROJECTION_TYPE, EVIDENCE_SELECTION_PROJECTION_TYPE, LIFECYCLE_GRAPH_INSTANCE_PROJECTION_TYPE, LIFECYCLE_ROUTE_PROJECTION_TYPE, STAGE_WORK_ORDER_PROJECTION_TYPE } from './lifecycle-graph.js';
+export const RUNTIME_PROJECTION_P0_CONTRACT_VERSION = 'phase9.19-runtime-sqlite-contract-projection-p0-v1';
+export const RUNTIME_REF_HASH_REGISTRY_PROJECTION_TYPE = 'phase9_19_ref_hash_registry';
+export const RUNTIME_REF_HASH_REGISTRY_PRODUCER_VERSION = 'phase9.19-ref-hash-registry-v1';
+export const STAGE_ROUTE_BINDING_PROJECTION_TYPE = 'phase9_18_stage_route_binding';
+export const STAGE_ROUTE_BINDING_PRODUCER_VERSION = 'phase9.18-stage-route-binding-v1';
+export const TRUTH_RECONCILIATION_PROJECTION_TYPE = 'phase9_21_truth_reconciliation';
+export const RUNTIME_PROJECTION_P0_INVENTORY = [
+    inventoryItem('lifecycleDecisions', 'sqlite', 'projections:phase8_lifecycle_risk_decision', 'Lifecycle/risk authority created only by /sdd or /sdd:spec.', ['router', 'stage-close', 'status', 'doctor']),
+    inventoryItem('riskSignals', 'sqlite', 'projections:phase8_lifecycle_risk_decision', 'Risk signal snapshot and lifecycle policy output for routing and gates.', ['router', 'workflow-gate', 'status']),
+    inventoryItem('stageRuns', 'sqlite', 'projections:phase8_stage_run', 'Runtime-owned stage run state and terminal health.', ['status', 'stage-close', 'ship']),
+    inventoryItem('stageHandoffs', 'sqlite', 'projections:phase8_workflow_handoff', 'Runtime handoff packet between completed stages and next runtime stage.', ['status', 'stage-close']),
+    inventoryItem('gates', 'sqlite', 'workflow_gate_decisions', 'Hard gate decisions and policy outcomes.', ['workflow-gate', 'status', 'ship']),
+    inventoryItem('gapBlockers', 'sqlite', 'durable_gaps', 'Mutable gap/blocker lifecycle with runtime status authority.', ['doctor', 'status', 'stage-close']),
+    inventoryItem('evidenceItems', 'sqlite-ref-hash-only', 'stage_artifacts/artifact_payloads', 'Agent-authored Markdown evidence registered by ref, hash, contract, producer, and status.', ['workflow-gate', 'stage-close', 'doctor']),
+    inventoryItem('evidenceSets', 'sqlite-ref-hash-only', 'evidence_sets/evidence_set_items', 'Accepted evidence sets selected by refs and digests, not Markdown bodies.', ['workflow-gate', 'ship', 'status']),
+    inventoryItem('selectionPointers', 'sqlite', 'selection_pointers', 'Active accepted evidence pointer for downstream consumers.', ['workflow-gate', 'latest-eligible-run', 'ship']),
+    inventoryItem('workflowCurrentState', 'sqlite-projection', `projections:${WORKFLOW_CURRENT_STATE_PROJECTION_TYPE}`, 'Runtime-owned lifecycle, task, and validation-unit current state projection.', ['status', 'router', 'ai-tool-entry']),
+    inventoryItem('taskOrchestration', 'sqlite-projection', `projections:${TASK_ORCHESTRATION_PROJECTION_TYPE}`, 'Parsed task orchestration read model with task-level hashes, dependencies, validation unit binding, and capability signals.', ['status', 'do-manager', 'tasks-manager']),
+    inventoryItem('validationUnits', 'sqlite-projection', `projections:${VALIDATION_UNIT_PROJECTION_TYPE}`, 'Runtime validation-unit read model derived from verify contracts and task orchestration.', ['status', 'test-manager', 'workflow-gate']),
+    inventoryItem('truthAlignment', 'sqlite', 'projections:phase9_12_truth_alignment', 'Goal-verify truth alignment projection for ship readiness.', ['ship', 'status']),
+    inventoryItem('truthReconciliation', 'sqlite', `projections:${TRUTH_RECONCILIATION_PROJECTION_TYPE}`, 'Owner-stage reconciliation decision slot for minimal rerun frontier.', ['orchestrator', 'status', 'ship']),
+    inventoryItem('stageRouteBindings', 'sqlite', `projections:${STAGE_ROUTE_BINDING_PROJECTION_TYPE}`, 'Stage-local command input binding to an accepted runtime target.', ['router', 'status']),
+    inventoryItem('nextIntent', 'sqlite-projection', `projections:${NEXT_INTENT_PROJECTION_TYPE}`, 'Advisory runtime next-action read model; execution still checks readiness and gates.', ['status', 'ai-tool-entry']),
+    inventoryItem('lifecycleGraphInstances', 'sqlite-projection', `projections:${LIFECYCLE_GRAPH_INSTANCE_PROJECTION_TYPE}`, 'Runtime-owned lifecycle graph instance derived from active lifecycle risk authority.', ['status', 'instructions', 'doctor', 'router', 'stage-close']),
+    inventoryItem('lifecycleRoutes', 'sqlite-projection', `projections:${LIFECYCLE_ROUTE_PROJECTION_TYPE}`, 'Graph-owned legal next action and blocker route projection.', ['status', 'instructions', 'doctor', 'router']),
+    inventoryItem('stageWorkOrders', 'sqlite-projection', `projections:${STAGE_WORK_ORDER_PROJECTION_TYPE}`, 'Stage-local work order schemas, required refs, and closure commands.', ['instructions', 'stage-close', 'do-manager', 'test-manager']),
+    inventoryItem('evidenceSelections', 'sqlite-projection', `projections:${EVIDENCE_SELECTION_PROJECTION_TYPE}`, 'Runtime-selected evidence obligations and selected accepted refs.', ['status', 'stage-close', 'workflow-gate', 'doctor']),
+    inventoryItem('diagnosticProjections', 'sqlite-projection', `projections:${DIAGNOSTIC_PROJECTION_TYPE}`, 'Blocker-specific diagnostics and recovery commands for lifecycle graph consumers.', ['doctor', 'status', 'instructions', 'router']),
+    inventoryItem('auditEvents', 'sqlite', 'events/activities', 'Append-only runtime events and activity records for auditability.', ['doctor', 'run-inspect'])
+];
+export const RUNTIME_PROJECTION_P0_PROJECTION_TYPES = [
+    'phase8_lifecycle_risk_decision',
+    'phase8_stage_run',
+    'phase8_workflow_handoff',
+    'phase9_12_truth_alignment',
+    TRUTH_RECONCILIATION_PROJECTION_TYPE,
+    STAGE_ROUTE_BINDING_PROJECTION_TYPE,
+    WORKFLOW_CURRENT_STATE_PROJECTION_TYPE,
+    TASK_ORCHESTRATION_PROJECTION_TYPE,
+    VALIDATION_UNIT_PROJECTION_TYPE,
+    NEXT_INTENT_PROJECTION_TYPE,
+    LIFECYCLE_GRAPH_INSTANCE_PROJECTION_TYPE,
+    LIFECYCLE_ROUTE_PROJECTION_TYPE,
+    STAGE_WORK_ORDER_PROJECTION_TYPE,
+    EVIDENCE_SELECTION_PROJECTION_TYPE,
+    DIAGNOSTIC_PROJECTION_TYPE,
+    RUNTIME_REF_HASH_REGISTRY_PROJECTION_TYPE
+];
+export async function inspectRuntimeProjectionP0(projectRoot, branch) {
+    const partition = branchToSafePartition(branch);
+    const projections = await listRuntimeProjections(projectRoot, [...RUNTIME_PROJECTION_P0_PROJECTION_TYPES]);
+    const projectionCounts = Object.fromEntries(RUNTIME_PROJECTION_P0_PROJECTION_TYPES.map((projectionType) => [projectionType, projections.filter((projection) => projection.projectionType === projectionType).length]));
+    const envelope = await readRuntimeRefHashRegistryProjection(projectRoot, partition);
+    const refHashRegistry = await inspectRefHashRegistry(projectRoot, partition, envelope);
+    const status = refHashRegistry.status === 'blocked' ? 'blocked' : envelope ? 'pass' : 'warn';
+    const reasons = runtimeProjectionP0Reasons(status, refHashRegistry.reasons);
+    return {
+        contract: RUNTIME_PROJECTION_P0_CONTRACT_VERSION,
+        branch: partition,
+        status,
+        inventory: [...RUNTIME_PROJECTION_P0_INVENTORY],
+        projectionCounts,
+        refHashRegistry,
+        reasons
+    };
+}
+export async function recordRuntimeRefHashRegistryProjection(projectRoot, input) {
+    const branch = branchToSafePartition(input.branch);
+    const refs = await inspectRuntimeRefFreshness(projectRoot, input.refs);
+    const staleRefs = refs.filter((ref) => blocksRefHashRegistry(ref.status)).map((ref) => ref.ref);
+    const projection = {
+        contract: RUNTIME_PROJECTION_P0_CONTRACT_VERSION,
+        branch,
+        refs,
+        status: staleRefs.length === 0 ? 'fresh' : 'blocked',
+        staleRefs,
+        reasons: refHashRegistryReasons(staleRefs, refs)
+    };
+    return recordRuntimeProjectionEnvelope(projectRoot, {
+        projectionType: RUNTIME_REF_HASH_REGISTRY_PROJECTION_TYPE,
+        scopeKey: runtimeRefHashRegistryScopeKey(branch),
+        inputHash: runtimeProjectionStableHash(projection),
+        producer: 'phase9.19-runtime-projection-p0',
+        producerVersion: RUNTIME_REF_HASH_REGISTRY_PRODUCER_VERSION,
+        generatedAt: input.generatedAt,
+        payload: projection
+    });
+}
+export async function readRuntimeRefHashRegistryProjection(projectRoot, branch) {
+    return readRuntimeProjectionEnvelope(projectRoot, RUNTIME_REF_HASH_REGISTRY_PROJECTION_TYPE, runtimeRefHashRegistryScopeKey(branchToSafePartition(branch)));
+}
+export async function inspectRuntimeRefFreshness(projectRoot, refs) {
+    return Promise.all(refs.map((ref) => inspectRuntimeRef(projectRoot, ref)));
+}
+export function runtimeRefHashRegistryScopeKey(branch) {
+    return [branchToSafePartition(branch), 'ref-hash-registry'].join(':');
+}
+export function runtimeProjectionStableHash(value) {
+    return createHash('sha256').update(JSON.stringify(value)).digest('hex');
+}
+async function inspectRefHashRegistry(projectRoot, branch, envelope) {
+    if (!envelope) {
+        return {
+            projectionType: RUNTIME_REF_HASH_REGISTRY_PROJECTION_TYPE,
+            envelopeStaleness: 'unknown',
+            status: 'missing',
+            staleRefs: [],
+            reasons: ['Runtime ref/hash registry projection is missing; register accepted Markdown refs before relying on freshness diagnostics.']
+        };
+    }
+    const currentRefs = await inspectRuntimeRefFreshness(projectRoot, envelope.payload.refs.map((entry) => entry.ref));
+    const staleRefs = currentRefs.filter((ref) => blocksRefHashRegistry(ref.status)).map((ref) => ref.ref);
+    const currentProjection = {
+        ...envelope.payload,
+        refs: currentRefs,
+        status: staleRefs.length === 0 ? 'fresh' : 'blocked',
+        staleRefs,
+        reasons: refHashRegistryReasons(staleRefs, currentRefs)
+    };
+    return {
+        projectionType: RUNTIME_REF_HASH_REGISTRY_PROJECTION_TYPE,
+        envelopeStaleness: runtimeProjectionStaleness(envelope, {
+            inputHash: runtimeProjectionStableHash(currentProjection),
+            producerVersion: RUNTIME_REF_HASH_REGISTRY_PRODUCER_VERSION
+        }),
+        status: currentProjection.status,
+        staleRefs,
+        reasons: currentProjection.reasons
+    };
+}
+async function inspectRuntimeRef(projectRoot, ref) {
+    const normalizedRef = normalizePortablePath(ref.ref);
+    if (!isFileBackedRef(ref)) {
+        return freshness(ref, normalizedRef, null, null, 'not_file_backed', `Runtime ref kind ${ref.kind} is not file-backed.`);
+    }
+    if (!ref.hash) {
+        return freshness(ref, normalizedRef, null, null, 'unhashed', `File-backed ref ${ref.ref} has no expected hash.`);
+    }
+    const safePath = safeProjectRelativePath(projectRoot, normalizedRef);
+    if (!safePath) {
+        return freshness(ref, normalizedRef, ref.hash, null, 'unsafe', `File-backed ref ${ref.ref} is not a safe project-relative path.`);
+    }
+    try {
+        const currentHash = hashDocumentContent(await readFile(safePath, 'utf8'));
+        return hashMatches(ref.hash, currentHash)
+            ? freshness(ref, normalizedRef, ref.hash, currentHash, 'fresh', `File-backed ref ${normalizedRef} is fresh.`)
+            : freshness(ref, normalizedRef, ref.hash, currentHash, 'stale', `File-backed ref ${normalizedRef} hash is stale: expected ${ref.hash}, actual ${currentHash}.`);
+    }
+    catch (error) {
+        if (isMissingFileError(error)) {
+            return freshness(ref, normalizedRef, ref.hash, null, 'missing', `File-backed ref ${normalizedRef} is missing.`);
+        }
+        throw error;
+    }
+}
+function inventoryItem(key, storage, primitive, responsibility, consumers) {
+    return { key, storage, primitive, writer: 'runtime', responsibility, consumers, markdownBodyAuthority: false };
+}
+function runtimeProjectionP0Reasons(status, refHashReasons) {
+    if (status === 'blocked') {
+        return refHashReasons;
+    }
+    if (status === 'warn') {
+        return ['Runtime projection P0 inventory is available; ref/hash freshness registry has not been recorded yet.'];
+    }
+    return ['Runtime projection P0 inventory is available and registered file-backed refs are fresh.'];
+}
+function refHashRegistryReasons(staleRefs, refs) {
+    if (staleRefs.length === 0) {
+        return ['Registered file-backed refs are fresh; non-file-backed refs remain metadata-only.'];
+    }
+    return refs.filter((ref) => blocksRefHashRegistry(ref.status)).map((ref) => ref.reason);
+}
+function blocksRefHashRegistry(status) {
+    return status === 'stale' || status === 'missing' || status === 'unhashed' || status === 'unsafe';
+}
+function isFileBackedRef(ref) {
+    if (ref.kind === 'document' || ref.kind === 'artifact' || ref.kind === 'evidence') {
+        return true;
+    }
+    return /^(specs|runs)\//.test(normalizePortablePath(ref.ref));
+}
+function safeProjectRelativePath(projectRoot, normalizedRef) {
+    if (path.isAbsolute(normalizedRef) || normalizedRef.startsWith('../') || normalizedRef === '..') {
+        return null;
+    }
+    const projectPath = path.resolve(projectRoot);
+    const absolutePath = path.resolve(projectPath, normalizedRef);
+    return absolutePath === projectPath || absolutePath.startsWith(`${projectPath}${path.sep}`) ? absolutePath : null;
+}
+function freshness(ref, normalizedRef, expectedHash, currentHash, status, reason) {
+    return { ref: { ...ref, ref: normalizedRef }, normalizedRef, expectedHash, currentHash, status, reason };
+}
+function hashMatches(expected, actual) {
+    return expected.replace(/^sha256:/, '') === actual.replace(/^sha256:/, '');
+}
+function isMissingFileError(error) {
+    if (!error || typeof error !== 'object') {
+        return false;
+    }
+    return 'code' in error && error.code === 'ENOENT';
+}
+//# sourceMappingURL=runtime-projection-p0.js.map

package/node_modules/@sdd-agent-platform/core/dist/runtime-projection-p0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-projection-p0.js","sourceRoot":"","sources":["../src/runtime-projection-p0.ts"],"names":[],"mappings":"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"}

package/node_modules/@sdd-agent-platform/core/dist/sdd-docs/artifact-depth.d.ts

@@ -0,0 +1,14 @@
+export type ArtifactDepthStage = 'spec' | 'plan' | 'tasks';
+export type ArtifactDepthIssueSeverity = 'blocker' | 'warning' | 'advisory';
+export interface ArtifactDepthIssue {
+    stage: ArtifactDepthStage;
+    severity: ArtifactDepthIssueSeverity;
+    code: string;
+    message: string;
+    repair: string;
+}
+export declare function evaluateSpecArtifactDepth(content: string): ArtifactDepthIssue[];
+export declare function evaluatePlanArtifactDepth(content: string): ArtifactDepthIssue[];
+export declare function evaluateTasksArtifactDepth(content: string): ArtifactDepthIssue[];
+export declare function formatArtifactDepthIssues(issues: ArtifactDepthIssue[]): string[];
+export declare function formatArtifactDepthBlockingIssues(issues: ArtifactDepthIssue[]): string[];

package/node_modules/@sdd-agent-platform/core/dist/sdd-docs/artifact-depth.js

@@ -0,0 +1,179 @@
+export function evaluateSpecArtifactDepth(content) {
+    const problem = extractMarkdownSection(content, 'Problem Reframing / Intent Discovery') ?? '';
+    const requirements = extractMarkdownSection(content, 'Requirements') ?? '';
+    const acceptance = extractMarkdownSection(content, 'Acceptance Criteria / Evidence Targets') ?? '';
+    const definitions = extractMarkdownSection(content, 'Definitions / Rules') ?? '';
+    const ambiguity = extractMarkdownSection(content, 'Open Questions / Ambiguity Ledger') ?? '';
+    const closeEvidence = extractMarkdownSection(content, 'Close Quality Evidence') ?? '';
+    const issues = [];
+    if (!/surface request/i.test(problem) || !/reframed problem/i.test(problem) || !/inferred real intent|real intent/i.test(problem)) {
+        issues.push(issue('spec', 'spec.too_thin.problem_reframing_missing', 'spec lacks problem reframing depth', 'Rewrite Problem Reframing / Intent Discovery with surface request, reframed problem, inferred intent, and observable success.', 'advisory'));
+    }
+    if (!/\bREQ-\d+\b/i.test(requirements) || !/reasoning|basis|source|constraint|because|why|rule|invariant|domain/i.test(`${requirements}\n${definitions}`)) {
+        issues.push(issue('spec', 'spec.too_thin.domain_rules_missing', 'spec requirements are not tied to domain rules or scope boundaries', 'Add requirement reasoning, source basis, domain rules, invariants, and scope boundaries before plan.', 'advisory'));
+    }
+    if (!/\bAC-\d+\b/i.test(acceptance) || !/evidence target/i.test(acceptance) || !/REQ-\d+/i.test(acceptance)) {
+        issues.push(issue('spec', 'spec.too_thin.acceptance_evidence_missing', 'spec acceptance criteria lack evidence targets tied to requirements', 'Add evidence targets for each core acceptance criterion and map them to requirement IDs.', 'warning'));
+    }
+    if (!/blocking user decisions?|blocking before plan|no blocking/i.test(ambiguity) || !/researchable|resolved by scout|scout|safe assumptions?|assumptions?|deferred/i.test(ambiguity)) {
+        issues.push(issue('spec', 'spec.ambiguity.unrouted', 'spec ambiguity is not explicitly routed', 'Classify uncertainty into researchable gaps, blocking user decisions, assumptions, and deferred items.', 'warning'));
+    }
+    if (closeEvidence && !/downstream_business_guesswork_remaining\s*:\s*\[\s*\]/i.test(closeEvidence)) {
+        issues.push(issue('spec', 'spec.downstream_guesswork.plan_would_rediscover_requirements', 'spec leaves downstream business guesswork for plan', 'Either resolve business guesswork in spec or route it as a blocking user decision before close.', 'blocker'));
+    }
+    return issues;
+}
+export function evaluatePlanArtifactDepth(content) {
+    const implementationMap = extractMarkdownSection(content, 'Current Implementation Map') ?? '';
+    const interfaceDesign = extractMarkdownSection(content, 'Interface / API / Schema Design') ?? '';
+    const stateDesign = extractMarkdownSection(content, 'State / Data / Concurrency Design') ?? '';
+    const validationStrategy = extractMarkdownSection(content, 'Validation Strategy') ?? '';
+    const riskControls = extractMarkdownSection(content, 'Risk Controls') ?? '';
+    const closeEvidence = extractMarkdownSection(content, 'Plan Close Quality Evidence') ?? '';
+    const issues = [];
+    if (!hasConcreteImplementationSurface(implementationMap)) {
+        issues.push(issue('plan', 'plan.too_thin.current_implementation_facts_not_reasoned', 'plan lacks reasoned current implementation facts', 'Connect observed files/classes/data facts to design implications, ownership, reuse/change/do-not-reuse decisions, or scout gaps.', 'advisory'));
+    }
+    if (!hasApiShape(interfaceDesign)) {
+        issues.push(issue('plan', 'plan.too_thin.api_shape_not_decided', 'plan API/interface shape is undecided', 'Specify request/query fields, response DTO/VO shape, error behavior, pagination, and owner surface where applicable.', 'warning'));
+    }
+    if (!hasSqlOrDataMappingDepth(interfaceDesign, stateDesign)) {
+        issues.push(issue('plan', 'plan.too_thin.sql_mapping_missing_join_keys', 'plan SQL/data mapping lacks executable depth', 'Name source fields, join keys, grouping/distinct rules, mapper ownership, date/status filters, or justify non-applicability.', 'warning'));
+    }
+    if (!hasScenarioValidationMatrix(validationStrategy, riskControls)) {
+        issues.push(issue('plan', 'plan.too_thin.validation_not_scenario_level', 'plan validation is not scenario-level', 'Add scenario rows with input/user action, expected API/UI/SQL result, evidence command/manual check, proves, and does-not-prove.', 'warning'));
+    }
+    if (looksDenseButShallow(implementationMap, interfaceDesign, riskControls)) {
+        issues.push(issue('plan', 'plan.dense_but_shallow.code_facts_not_connected_to_decisions', 'plan is dense but code/data facts are not connected to decisions', 'For each important fact, state the design implication, selected decision, rejected alternative, and risk control.', 'warning'));
+    }
+    if (leaksDesignDecisionToImplementation(interfaceDesign, stateDesign)) {
+        issues.push(issue('plan', 'plan.downstream_guesswork.tasks_or_execute_would_redesign', 'plan leaks design decisions to implementation', 'Resolve API/SQL/data decisions in plan before tasks or execute consume the design.', 'blocker'));
+    }
+    if (closeEvidence && !/downstream_design_guesswork_remaining\s*:\s*\[\s*\]/i.test(closeEvidence)) {
+        issues.push(issue('plan', 'plan.downstream_guesswork.tasks_or_execute_would_redesign', 'plan leaves design guesswork for tasks or execute', 'Resolve or explicitly route design guesswork before tasks consume the plan.', 'blocker'));
+    }
+    return issues;
+}
+export function evaluateTasksArtifactDepth(content) {
+    const splitBasis = extractMarkdownSection(content, ['Split Basis', 'Task Split Basis', 'Work Unit Split Basis']) ?? '';
+    const implementationTasks = extractMarkdownSection(content, ['Implementation Tasks', 'Implementation Work Units', 'Implementation Task Units']) ?? '';
+    const validationTasks = extractMarkdownSection(content, ['Validation Tasks', 'Validation Work Units', 'Validation Task Units']) ?? '';
+    const dependencies = extractMarkdownSection(content, ['Task Dependencies and Handoff', 'Dependencies and Validation Handoff', 'Task Dependency and Validation Handoff']) ?? '';
+    const openQuestions = extractMarkdownSection(content, ['Open Execution Questions', 'Open Questions', 'Execution Questions']) ?? '';
+    const closeEvidence = extractMarkdownSection(content, ['Tasks Close Quality Evidence', 'Close Quality Evidence']) ?? '';
+    const issues = [];
+    if (!/why this task exists|work-unit context|plan decision|design part|must not reinterpret|risk/i.test(implementationTasks)) {
+        issues.push(issue('tasks', 'tasks.too_thin.work_unit_context_missing', 'implementation tasks lack work-unit context', 'Explain which plan decision each task implements, why the boundary exists, and what execute must not reinterpret.', 'warning'));
+    }
+    if (!/validationHandoff\s*:/i.test(implementationTasks)) {
+        issues.push(issue('tasks', 'tasks.parser.missing_validation_handoff', 'implementation tasks lack validation handoff metadata', 'Add validationHandoff metadata from each implementation task to later validation task IDs.', 'blocker'));
+    }
+    if (!/validatesImplementationTasks\s*:/i.test(validationTasks) && !/validates_implementation_tasks\s*:/i.test(validationTasks)) {
+        issues.push(issue('tasks', 'tasks.parser.missing_validates_implementation_tasks', 'validation tasks lack implementation task refs', 'Add validatesImplementationTasks metadata to each validation task.', 'blocker'));
+    }
+    if (!/expected result|pass criteria|evidence is enough|does not prove|acceptance checks|manual inspection|test/i.test(validationTasks)) {
+        issues.push(issue('tasks', 'tasks.validation.expected_result_missing', 'validation tasks lack expected results', 'Add expected result, sufficient evidence, and does-not-prove notes for validation tasks.', 'warning'));
+    }
+    if (!/failure routing|failure route|return to|plan repair|spec\/user decision|environment diagnostic|tasks repair/i.test(`${validationTasks}\n${openQuestions}`)) {
+        issues.push(issue('tasks', 'tasks.failure_route.missing', 'tasks lack failure routes', 'Add failure routes to implementation task, tasks repair, plan repair, spec/user decision, or environment diagnostic.', 'blocker'));
+    }
+    if (isOversizedExecutionSlice(implementationTasks) && !hasExecutionSliceDecision(`${splitBasis}\n${implementationTasks}\n${dependencies}`)) {
+        issues.push(issue('tasks', 'tasks.review.split_adjudication_missing', 'tasks contain a broad execution slice without recorded tasks-stage split adjudication', 'Have task-reviewer flag the slice and tasks-manager either split it or record why the rollback unit stays together with an internal execution order before close.', 'warning'));
+    }
+    if (/rollback unit/i.test(implementationTasks) && /parallel/i.test(dependencies) && !/rollback boundary|reverted together|shared rollback|separate rollback|rollback units? stay separate|rollback-separated/i.test(dependencies)) {
+        issues.push(issue('tasks', 'tasks.boundary.rollback_unit_torn', 'tasks parallelism may tear rollback units', 'Explain rollback boundaries and why parallel tasks do not modify the same rollback unit unsafely.', 'blocker'));
+    }
+    if (/execute (?:will|should|must) decide|decide in execute|tbd in execute|implementation will determine|finalize during execute|确定|待实现时确定/i.test(`${implementationTasks}\n${openQuestions}`)) {
+        issues.push(issue('tasks', 'tasks.plan_repair.design_guesswork_leaked_to_execute', 'tasks leak design guesswork into execute', 'Route unresolved SQL/API/data design decisions back to plan before execute.', 'blocker'));
+    }
+    if (closeEvidence && !/downstream_execution_guesswork_remaining\s*:\s*\[\s*\]/i.test(closeEvidence)) {
+        issues.push(issue('tasks', 'tasks.plan_repair.design_guesswork_leaked_to_execute', 'tasks leave execution guesswork unresolved', 'Resolve execution guesswork in tasks or route it to tasks/plan/spec repair before close.', 'blocker'));
+    }
+    return issues;
+}
+export function formatArtifactDepthIssues(issues) {
+    return issues.map((item) => `${item.severity}:${item.code}: ${item.message}. ${item.repair}`);
+}
+export function formatArtifactDepthBlockingIssues(issues) {
+    return formatArtifactDepthIssues(issues.filter((item) => item.severity === 'blocker'));
+}
+function issue(stage, code, message, repair, severity = 'warning') {
+    return { stage, severity, code, message, repair };
+}
+function hasConcreteImplementationSurface(section) {
+    if (/scout gap|needs scout|unresolved gap|not applicable|no existing surface/i.test(section)) {
+        return true;
+    }
+    const namedSurfaces = section.match(/\b[A-Z][A-Za-z0-9_]*(?:Controller|Service|ServiceImpl|Mapper|Repository|Entity|DTO|VO|Request|Response|Component|Page|Config|Test)\b/g) ?? [];
+    const fileRefs = section.match(/`[^`]+\.(?:ts|tsx|js|jsx|java|kt|go|py|rs|xml|sql|jsp|vue|md)`/g) ?? [];
+    return namedSurfaces.length + fileRefs.length >= 2 && /reuse|change|do-not-reuse|do not reuse|owner|ownership|convention|boundary|surface|implication|decision|because|therefore/i.test(section);
+}
+function hasApiShape(section) {
+    if (/not applicable|no interface|no api|no schema/i.test(section) && /because|checked|reason/i.test(section)) {
+        return true;
+    }
+    if (/TypeScript function contract|runtime-store projection schema|projection schema|function contract/i.test(section) && /field|schema|ref|hash|status|owner/i.test(section)) {
+        return true;
+    }
+    return /\b(query|request|response|DTO|VO|endpoint|controller|service|mapper|分页|权限|错误|响应包装)\b/i.test(section)
+        && /\b(field|default|required|optional|error|pagination|shape|字段|参数|返回|错误|分页)\b/i.test(section)
+        && (section.match(/`[^`]+`/g) ?? []).length >= 4;
+}
+function hasSqlOrDataMappingDepth(interfaceDesign, stateDesign) {
+    const combined = `${interfaceDesign}\n${stateDesign}`;
+    if (/not applicable|no sql|no database|no data mapping/i.test(combined) && /because|checked|reason/i.test(combined)) {
+        return true;
+    }
+    if (/runtime-store projection schema|projection state|projection persistence|runtime projection/i.test(combined) && /ref|hash|scopeKey|projectionType|status|rollback/i.test(combined)) {
+        return true;
+    }
+    const requiresSqlDepth = /\b(SQL|MyBatis|mapper XML|database|table|column|join|aggregate|distinct|source field|表|字段|聚合|分组|去重)\b/i.test(combined);
+    if (!requiresSqlDepth) {
+        return true;
+    }
+    return /\b(join key|join keys|foreign key|primary key|source field|mapper owner|grouping|distinct|pagination|filter|status filter|date range|关联键|主键|外键|来源字段|分组|去重|分页|过滤)\b/i.test(combined)
+        && (combined.match(/`[^`]+`/g) ?? []).length >= 5;
+}
+function hasScenarioValidationMatrix(validationStrategy, riskControls) {
+    const combined = `${validationStrategy}\n${riskControls}`;
+    const hasScenario = /scenario|input data|user action|expected|proves|does not prove|场景|输入|预期|证明/i.test(combined);
+    const hasEvidence = /command|evidence|manual|test|api|ui|sql|hook|artifact|证据|检查/i.test(combined);
+    const hasRiskLink = /risk|impact|control|validation hook|task-stage constraint|风险|影响|控制/i.test(combined);
+    return hasScenario && hasEvidence && hasRiskLink;
+}
+function looksDenseButShallow(...sections) {
+    const text = sections.join('\n');
+    const lineCount = text.split(/\r?\n/).filter((line) => line.trim().length > 0).length;
+    const factCount = (text.match(/`[^`]+`|\b[A-Z][A-Za-z0-9_]*(?:Controller|Service|Mapper|Entity|DTO|VO|Request|Response)\b/g) ?? []).length;
+    const reasoningCount = (text.match(/because|therefore|implies|decision|tradeoff|risk control|validation hook|why|so that|因此|所以|取舍|决策|风险控制/g) ?? []).length;
+    return lineCount >= 12 && factCount >= 8 && reasoningCount < 3;
+}
+function leaksDesignDecisionToImplementation(...sections) {
+    return /implementation will determine|finali[sz](?:e|ed) during implementation|decide in implementation|implementation phase will decide|execute (?:will|should|must) decide|decide in execute|tbd in execute|待实现时确定|执行时确定/i.test(sections.join('\n'));
+}
+function isOversizedExecutionSlice(section) {
+    const codeBlocks = (section.match(/```sdd-task/g) ?? []).length;
+    const touchedAreas = (section.match(/affectedAreas\s*:|affected_files\s*:|Allowed code changes|Allowed files|Controller|Service|Mapper|DTO|VO|XML|SQL|UI|JSP|Vue|React/gi) ?? []).length;
+    return codeBlocks <= 2 && touchedAreas >= 8;
+}
+function hasExecutionSliceDecision(section) {
+    return /execution slice|split rationale|split chain|split from|work-unit boundary|keep together|single rollback unit|sequence|internal order|ordered steps|step order|rollback unit|rollback boundary|tasks-manager|task manager|reviewed split|split decision|裁决|不拆分|保留|内部顺序|执行顺序|回滚单元/i.test(section);
+}
+function extractMarkdownSection(content, section) {
+    for (const sectionName of Array.isArray(section) ? section : [section]) {
+        const escaped = escapeRegex(sectionName).replace(/\s+/g, '\\s+');
+        const match = new RegExp(`^##\\s+(?:\\d+(?:\\.\\d+)*\\.?\\s+)?${escaped}\\s*$`, 'im').exec(content);
+        if (!match) {
+            continue;
+        }
+        const start = match.index + match[0].length;
+        const rest = content.slice(start);
+        const next = /^##\s+/im.exec(rest);
+        return (next ? rest.slice(0, next.index) : rest).trim();
+    }
+    return null;
+}
+function escapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=artifact-depth.js.map

package/node_modules/@sdd-agent-platform/core/dist/sdd-docs/artifact-depth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-depth.js","sourceRoot":"","sources":["../../src/sdd-docs/artifact-depth.ts"],"names":[],"mappings":"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"}

package/node_modules/@sdd-agent-platform/core/dist/sdd-docs/task-parser.d.ts

@@ -1,8 +1,9 @@
 export type SddTaskStatus = 'pending' | 'in_progress' | 'completed' | 'blocked' | 'deferred' | 'unknown';
-export type SddChangeSurface = 'frontend_only' | 'backend_only' | 'full_stack' | 'docs_only' | 'config_only' | 'unknown';
+export type SddChangeSurface = 'frontend_only' | 'backend_only' | 'full_stack' | 'docs_only' | 'config_only' | 'cli_only' | 'unknown';
 export type SddValidationTiming = 'task_end' | 'batch_end' | 'wave_end';
 export type SddGapSeverity = 'blocking' | 'warning';
 export type SddGapType = 'Document Gap' | 'Task Gap' | 'Dependency Gap';
+export type SddTaskClass = 'implementation' | 'validation';
 export interface SddTaskSourceLocation {
     filePath: string;
     heading: string | null;
@@ -19,12 +20,15 @@ export interface SddTask {
     title: string | null;
     status: SddTaskStatus;
     wave: number | null;
+    taskClass: SddTaskClass | null;
+    unitType: string | null;
     implementationWave: string | null;
     validationBatch: string | null;
     validationTiming: SddValidationTiming;
     requiresVerifyBeforeNext: boolean;
     changeSurface: SddChangeSurface;
     dependsOn: string[];
+    validationHandoff: string[];
     affectedFiles: string[];
     validation: string[];
     validationCommands: SddValidationCommand[];