sdd-agent-platform 0.3.0 → 0.4.1

package/packages/core/dist/instructions.js

@@ -0,0 +1,147 @@
+import { SDD_VERSION } from './ai-tools.js';
+export const SDD_INSTRUCTIONS_CONTRACT = 'sdd-instructions-v1';
+const INSTRUCTION_PAYLOADS = {
+    overview: {
+        summary: 'Route natural-language SDD intent from branch/source status to task execution, agent evidence, strict verification-contract consumption, and release readiness while keeping CLI/core output as source of truth.',
+        requiredCommands: ['sdd status', 'sdd lifecycle decide --from-text <text>', 'sdd doctor', 'sdd tasks inspect <task_id>', 'sdd do task <task_id>', 'sdd test task <task_id> --branch <branch>', 'sdd test batch <batch_id> --branch <branch>', 'sdd test wave --branch <branch> --wave <n>', 'sdd ship --branch <branch> --dry-run', 'sdd instructions ship --json'],
+        allowedSideEffects: ['read .sdd state', 'read specs documents', 'read generated AI entries'],
+        forbiddenSideEffects: ['background write', 'worktree creation', 'auto commit', 'force push', 'unapproved sync-back apply', 'publish or push release artifacts without explicit human confirmation'],
+        nextSteps: [
+            'Treat /sdd as a natural-language intent router, then run sdd status first to see branch/source context and the recommended next command; report only workflow state, blocker/current task, and next action unless the user asks for full detail.',
+            'Dynamic routing comes from CLI/core output; follow the recommended next command and do not infer dynamic state from generated markdown.',
+            'If intent remains ambiguous after status, ask one clarifying question before spec/plan/tasks/do/test/ship work.',
+            'If status reports generated entry drift, missing config, compatibility drift, or legacy sync-back state, run sdd doctor and use diagnostic/recovery commands before normal do/test/ship.',
+            'If status recommends a pending task, run sdd tasks inspect <task_id> and execute only the approved task boundary; scout/implementer/reviewer/validator participation should be recorded as artifacts rather than hidden in the main chat.',
+            'For test, follow the task contract boundary: strict/task_end work uses sdd test task, batch_end work uses sdd test batch, and wave_end work uses sdd test wave; pass --run only for replay, CI, or old-run inspection.',
+            'After the selected test boundary returns PASS, proceed to a decision card if policy requires one, otherwise run `sdd ship --branch <branch> --dry-run`.',
+            'Use `sdd sync-back inspect|apply` only for explicit diagnostic, recovery, replay, or legacy compatibility work; do not add it as a normal happy-path step.'
+        ]
+    },
+    init: {
+        summary: 'Initialize .sdd project configuration and managed AI tool entries for the current repository; workflow partition documents are entered through the spec stage, not init.',
+        requiredCommands: ['sdd init --ai claude-code', 'sdd status', 'sdd instructions spec --json', 'sdd doctor'],
+        allowedSideEffects: ['write .sdd/project.yml', 'write .sdd/runs', 'write managed generated AI entries'],
+        forbiddenSideEffects: ['create workflow partition documents unless explicitly using the spec stage or legacy --scaffold-docs', 'overwrite foreign AI entry files', 'background write', 'auto commit'],
+        nextSteps: ['Run sdd init --ai claude-code.', 'Run sdd status to inspect current Git branch partition state and the recommended next command.', 'Use the spec stage to create or refine specs/<partition>/spec.md; omitted --branch uses the current Git branch, explicit --branch uses the requested partition.', 'Run sdd doctor after initialization.']
+    },
+    doctor: {
+        summary: 'Check project config, scoped runtime evidence, generated AI entry drift, and deterministic recover/reconcile guidance.',
+        requiredCommands: ['sdd doctor fast --branch <branch>', 'sdd doctor deep --branch <branch>', 'sdd doctor recover --branch <branch>', 'sdd run archive <run_id> --reason <text>'],
+        allowedSideEffects: ['read .sdd state', 'read specs documents', 'read generated AI entries', 'archive failed exploratory run state when explicitly requested'],
+        forbiddenSideEffects: ['delete run evidence', 'write project source files', 'background write', 'worktree creation', 'run deep historical scans unless explicitly requested'],
+        nextSteps: ['Run sdd doctor fast for normal current-run health checks.', 'Use sdd doctor deep for explicit historical audit.', 'Use sdd doctor recover for deterministic rebuild/reinspect/reconcile guidance without automatic destructive cleanup.', 'Use sdd run archive <run_id> --reason <text> for failed exploratory runs instead of deleting evidence.', 'Run sdd update if generated entry drift is reported.']
+    },
+    update: {
+        summary: 'Refresh missing or drifted managed AI tool entries.',
+        requiredCommands: ['sdd update', 'sdd doctor'],
+        allowedSideEffects: ['write managed generated AI entries'],
+        forbiddenSideEffects: ['overwrite foreign AI entry files', 'modify user source code', 'auto commit'],
+        nextSteps: ['Run sdd update.', 'Run sdd doctor to verify drift is resolved.']
+    },
+    spec: {
+        summary: 'Create or refine specs/<partition>/spec.md as the workflow partition entry: omitted --branch uses the current Git branch, explicit --branch uses the requested branch partition.',
+        requiredCommands: ['sdd status', 'sdd lifecycle decide --from-text <text>', 'read specs/<partition>/spec.md', 'write specs/<partition>/spec.md'],
+        allowedSideEffects: ['read project context', 'create or read the resolved specs/<partition> directory', 'write proposed or approved requirement contract'],
+        forbiddenSideEffects: ['implement code', 'design technical solution in spec.md', 'silently advance to plan', 'auto commit'],
+        nextSteps: ['Resolve the workflow partition: omit --branch to use the current Git branch, or pass --branch <name> only when intentionally writing another partition.', 'Clarify user intent, objective/customer value, actors, scenarios, scope, and non-goals.', 'Run sdd lifecycle decide --from-text <text> when changes mention state-machine, concurrency, database, SQL, security, API/schema, CI/build, or external unknown risk.', 'Write acceptance criteria with stable IDs such as AC-1 and verification hints.', 'Record assumptions/dependencies, risks/hard gates, open questions, and lifecycle reference.', 'If this is a requirement change after plan/tasks/run work exists, update spec.md and let status expose stale downstream hashes before continuing.', 'Stop before technical design or implementation when requirement gaps remain.']
+    },
+    plan: {
+        summary: 'Refine specs/<partition>/plan.md as a deliverable technical solution document that bridges approved spec requirements into task-ready design and records based_on_spec_hash.',
+        requiredCommands: ['sdd status', 'read specs/<partition>/spec.md', 'read specs/<partition>/plan.md', 'write specs/<partition>/plan.md'],
+        allowedSideEffects: ['read project context', 'read spec document', 'write proposed or approved technical solution plan document'],
+        forbiddenSideEffects: ['implement code', 'silently advance to tasks', 'bypass unresolved spec gaps'],
+        nextSteps: ['Read the approved spec and acceptance criteria plus the current spec hash from sdd status.', 'Record based_on_spec_hash in plan.md so later spec-stage revisions can mark this plan stale.', 'Write plan.md as a technical solution document: background, goals/non-goals, current state, target design, architecture/component impact, interaction/sequence design, state/data design, API/schema design, concurrency/transaction/consistency design, key decisions, alternatives, risk control, rollout/rollback, validation matrix, and task breakdown rationale.', 'Use PlantUML diagrams when they clarify component impact, sequence/activity flow, state machines, or deployment/data relationships.', 'Apply risk-driven requirements: state-machine needs state design, concurrency needs sequence/activity and consistency design, database needs data/transaction/rollback design, api_schema needs interface/schema compatibility, security/sql needs risk control.', 'Stop with explicit plan gaps and tasks readiness.']
+    },
+    tasks: {
+        summary: 'Refine specs/<partition>/tasks.md and specs/<partition>/verify.md as frozen task and verification contracts with implementation waves, validation waves, and review gate declarations.',
+        requiredCommands: ['sdd status', 'read specs/<partition>/spec.md', 'read specs/<partition>/plan.md', 'sdd tasks format', 'write specs/<partition>/tasks.md', 'write specs/<partition>/verify.md', 'sdd tasks list', 'sdd tasks gaps', 'sdd verifies inspect --branch <branch>'],
+        allowedSideEffects: ['read spec and plan documents', 'write proposed or approved task execution/evidence contract', 'write task-derived verify contract'],
+        forbiddenSideEffects: ['implement code', 'execute dependency waves', 'run validation commands', 'silently advance to do', 'turn tasks.md into project-management backlog'],
+        nextSteps: ['Read approved spec acceptance IDs, approved plan design sections, and the current plan hash from sdd status.', 'Record based_on_plan_hash in tasks.md so later plan/spec revisions can mark these tasks stale.', 'Run sdd tasks format to get the canonical block format.', 'Map every task to acceptance_refs and plan_refs where applicable.', 'Declare change_surface, implementation_wave, validation_batch, validation_timing, requires_verify_before_next, required artifacts, and review gates before freezing tasks.', 'Use validation_timing task_end and requires_verify_before_next true for strict/high-risk tasks; use batch_end or wave_end with validation_batch only when sequential accumulation is safe.', 'Have the verification-designer produce verify.md from the frozen task contract, then inspect it with sdd verifies inspect --branch <branch>.', 'Keep #### Boundary, #### Acceptance, #### Definition of Done, #### Evidence Expectations, and #### Implementation Notes as companion sections outside the ```sdd-task fenced block; keep only metadata inside the fence.', 'Frontend-only tasks must not declare Maven/Gradle backend build validation.', 'For risky tasks, include allowed_agents, required_artifacts, verification_availability, and autonomy.', 'Run sdd tasks list and sdd tasks gaps.', 'Stop before do task when task boundary, acceptance refs, plan refs, evidence requirements, validation batches/waves, or verify expectations are unclear.']
+    },
+    verifies: {
+        summary: 'Create or inspect specs/<partition>/verify.md as the task-derived verification contract before runtime evidence execution.',
+        requiredCommands: ['sdd status', 'sdd tasks list --branch <branch>', 'sdd verifies inspect --branch <branch>', 'sdd verifies write --branch <branch>'],
+        allowedSideEffects: ['read spec, plan, and tasks documents', 'write specs/<partition>/verify.md when explicitly using write'],
+        forbiddenSideEffects: ['run validation commands', 'update runtime.sqlite run state', 'create sync-back proposal', 'modify source files', 'auto commit'],
+        nextSteps: ['Run sdd status and confirm tasks.md is current.', 'Run sdd verifies inspect --branch <branch> to check whether verify.md exists and matches the current tasks hash.', 'Run sdd verifies write --branch <branch> to create verify.md, or add --force after reviewing task contract changes.', 'Use verify.md to guide validator evidence expectations; do not treat it as runtime evidence or as a replacement for `sdd test task|batch|wave`.']
+    },
+    test: {
+        summary: 'Execute validation commands from the frozen tasks.md + verify.md contract boundary, capture command output, evaluate acceptance evidence coverage, and return one unified task, batch, or wave judgment without authoring verify.md.',
+        requiredCommands: ['sdd status', 'sdd test task <task_id> --branch <branch>', 'sdd test batch <batch_id> --branch <branch>', 'sdd test wave --branch <branch> --wave <n>'],
+        allowedSideEffects: ['run declared validation commands', 'write branch-scoped test evidence artifacts', 'update runtime.sqlite test run and validation wave records', 'write validator evidence artifact'],
+        forbiddenSideEffects: ['modify source files outside the validation command effects', 'author or refresh verify.md', 'apply sync-back', 'auto commit', 'publish or push', 'treat command success alone as semantic PASS'],
+        nextSteps: ['Run sdd status and resolve the task, batch, or wave boundary plus branch.', 'Confirm verify.md exists and is current for the selected branch; if it is missing or stale, return to /sdd:tasks or use explicit sdd verifies write recovery before executing tests.', 'Use sdd test task <task_id> --branch <branch> for strict/task_end tasks or deliberate narrowed overrides with --run, --command, --command-json, --command-file, or passthrough argv.', 'Use sdd test batch <batch_id> --branch <branch> or sdd test wave --branch <branch> --wave <n> for batch_end or wave_end tasks so accumulated implementation evidence is judged together.', 'Inspect the generated command logs, test index, validator artifacts, acceptance maps, and workflow gate decision.', 'If the selected test boundary returns PASS, proceed to a decision card if policy requires one, otherwise run `sdd ship --branch <branch> --dry-run`; if it returns FAIL or BLOCKED, fix the reported command/evidence gaps and rerun the same boundary.']
+    },
+    do: {
+        summary: 'Execute one approved task boundary through the ingestion-aware SDD task workflow with explicit scout/implementer/reviewer/validator evidence handoff.',
+        requiredCommands: ['sdd status', 'sdd instructions do --json', 'sdd tasks inspect <task_id>', 'sdd artifact template artifacts/<agent>-<task_id>.md --task <task_id> --agent <agent> --run <run_id> --write', 'sdd artifact validate <run_id> <artifact> --task <task_id> --agent <agent>', 'sdd do task <task_id>'],
+        allowedSideEffects: ['write branch-scoped .sdd/runs evidence artifacts', 'update runtime.sqlite run state', 'modify files within selected task boundary'],
+        forbiddenSideEffects: ['background write', 'worktree creation', 'auto commit', 'expand beyond selected task boundary without checkpoint', 'mark missing evidence as PASS'],
+        nextSteps: ['Run sdd status and resolve exactly one task id from the user request or recommended next command.', 'Run sdd instructions do --json and sdd tasks inspect <task_id>.', 'Restate only the task Boundary, blocking gaps, and validation commands before implementation.', 'Use scout for bounded context only, implementer for selected-boundary edits, reviewer for review evidence, and validator for validation plus acceptance mapping.', 'Create or resolve the task run id, then write implement/review/validation result artifacts only with sdd artifact template artifacts/<agent>-<task_id>.md --task <task_id> --agent <agent> --run <run_id> --write; do not manually create copies under specs/<branch>/artifacts/ or specs/<branch>/evidence/artifacts/.', 'Pass run-relative artifacts/<file> paths to CLI flags, and keep source/test files in ## Evidence, not in sdd-result.artifacts.', 'Run sdd artifact validate before passing artifacts into sdd do task <task_id>.', 'Run or coordinate implementation only within the selected task boundary.', 'Run sdd do task <task_id> with explicit artifact paths when evidence is available.', 'Report run id, final status, blocking gaps, and next gate; if completed, follow sdd status recommended next command: continue sequential sdd do task, run sdd test task for strict/task_end work, or run sdd test batch / sdd test wave at the declared validation boundary.']
+    },
+    verify: {
+        summary: 'Run compatibility/diagnostic task acceptance coverage from reviewer/validator artifacts, resolving the latest eligible run from partition + task id unless --run is explicit; `sdd test task|batch|wave` is the primary runtime gate.',
+        requiredCommands: ['sdd status', 'sdd instructions verify --json', 'sdd artifact template artifacts/validation-<task_id>.md --task <task_id> --agent validator --run <run_id> --write', 'sdd artifact validate <run_id> <artifact> --task <task_id> --agent validator', 'sdd verify task <task_id> [--branch <branch>] [--run <run_id>]'],
+        allowedSideEffects: ['write acceptance coverage artifact', 'update runtime.sqlite diagnostic verification state'],
+        forbiddenSideEffects: ['auto commit', 'force push', 'auto-fix failures', 'create sync-back proposal as normal happy path', 'unapproved sync-back apply', 'mark completed with blocking validation gaps'],
+        nextSteps: ['Run sdd status and resolve exactly one task id plus workflow partition from the recommended command or user request.', 'Omit --run by default so CLI resolves the latest eligible run for partition + task id; pass --run only for explicit replay, CI, or old-run inspection.', 'Ensure the validator artifact includes exact Acceptance text, preferably under ## Acceptance Mapping from sdd artifact template.', 'When a validator artifact must be created manually for a run, write it only with sdd artifact template artifacts/validation-<task_id>.md --task <task_id> --agent validator --run <run_id> --write; do not manually create copies under specs/<branch>/artifacts/ or specs/<branch>/evidence/artifacts/.', 'Pass run-relative artifacts/<file> paths to validate/verify CLI flags.', 'Run sdd artifact validate before compatibility verify.', 'Run sdd instructions verify --json and sdd verify task <task_id> --branch <branch> only for explicit low-level diagnostics.', 'For the primary lifecycle path, use `sdd test task|batch|wave`; after PASS proceed to a decision card if policy requires one or `sdd ship --branch <branch> --dry-run`.', 'Report PASS/BLOCKED status and unresolved blockers; avoid pasting full acceptance coverage unless requested.']
+    },
+    'sync-back': {
+        summary: 'Inspect or replay verified task completion write-back state for diagnostic, recovery, replay, and legacy compatibility use.',
+        requiredCommands: ['sdd status', 'sdd instructions sync-back --json', 'sdd sync-back inspect [<run_id>] --branch <branch> --task <task_id>', 'sdd sync-back apply [<run_id>] --branch <branch> --task <task_id> [--approved]'],
+        allowedSideEffects: ['read runtime.sqlite run state', 'read sync-back proposal artifact', 'read specs/<partition>/tasks.md', 'write specs/<partition>/tasks.md during apply', 'write specs/<partition>/verify.md only when explicit --refresh-verify is supplied', 'update run sync_back state only during apply'],
+        forbiddenSideEffects: ['auto commit', 'force push', 'apply without inspect', 'apply confirm-required proposals without human approval', 'change source files outside tasks.md'],
+        nextSteps: ['Run sdd status and resolve exactly one task id plus workflow partition from an explicit diagnostic, recovery, replay, CI, or old-run inspection request.', 'Run sdd sync-back inspect --branch <branch> --task <task_id> first; pass an explicit run id only for replay, CI, or old-run inspection.', 'Report the inspect target update before asking for approval: target tasks file, task id, markdown status transition, proposal path, evidence artifacts, apply_policy, and policy reasons.', 'If apply_policy=direct and status=ready, run sdd sync-back apply --branch <branch> --task <task_id> only for explicit recovery/replay; if approval_required=true, ask for explicit confirmation and then add --approved.', 'Explain that default apply writes the task block status to completed, appends the sync-back implementation note from the proposal/evidence, marks the run sync_back state applied, and rebuilds the local run index; --refresh-verify is an explicit recovery option after reviewed task-contract changes.', 'After apply, report the updated task id, tasks.md path, applied flag, and sync_back state.']
+    },
+    ship: {
+        summary: 'Run local release readiness and optionally write specs/<branch>/release.md without publishing, pushing, tagging, or changing external release state.',
+        requiredCommands: ['sdd ship --branch <branch> --dry-run', 'sdd ship --branch <branch>', 'sdd statusline --branch <branch>', 'sdd doctor fast --branch <branch>', 'sdd update --check', 'npm run typecheck', 'npm test', 'npm run build', 'npm pack --dry-run --json', 'git status'],
+        allowedSideEffects: ['read project status', 'read SDD documents and run evidence', 'write specs/<branch>/release.md when not using --dry-run', 'run local validation commands'],
+        forbiddenSideEffects: ['npm publish', 'git push', 'git tag', 'create GitHub release', 'force push', 'auto commit', 'skip failed gates', 'treat historical doctor debt as a release blocker unless it affects current run evidence'],
+        nextSteps: ['Run sdd ship --branch <branch> --dry-run to inspect PASS/BLOCKED readiness without writing release docs.', 'If readiness output is acceptable, run sdd ship --branch <branch> to write specs/<branch>/release.md.', 'Use sdd statusline --branch <branch> for compact runtime/test/team/token/evidence health.', 'Run current-run health checks with sdd doctor fast --branch <branch>; use sdd doctor deep only for explicit historical audit.', 'Run npm run typecheck, npm test, npm run build, and npm pack --dry-run --json when preparing a real package release.', 'Report PASS/BLOCKED by readiness check, including exact failed commands and unresolved manual confirmations.', 'Stop before npm publish, git push, git tag, or external release creation unless the user explicitly approves that separate action.']
+    },
+    'run-task': {
+        summary: 'Run the ingestion-aware task workflow using CLI/core runtime state and artifacts.',
+        requiredCommands: ['sdd tasks inspect <task_id>', 'sdd do task <task_id>'],
+        allowedSideEffects: ['write branch-scoped .sdd/runs evidence artifacts', 'update runtime.sqlite run state'],
+        forbiddenSideEffects: ['background write', 'worktree creation', 'auto commit'],
+        nextSteps: ['Inspect the task.', 'Run the task loop with explicit artifacts and validation evidence.']
+    },
+    'verify-task': {
+        summary: 'Verify task acceptance coverage using CLI/core verifier artifacts and partition-aware run resolution.',
+        requiredCommands: ['sdd verify task <task_id> [--branch <branch>] [--run <run_id>]'],
+        allowedSideEffects: ['write acceptance coverage artifact', 'update .sdd run state'],
+        forbiddenSideEffects: ['auto commit', 'force push', 'unapproved sync-back apply'],
+        nextSteps: ['Run goal-level verify without --run for the latest eligible partition/task run, unless inspecting an explicit run.', 'Use sdd test task for primary lifecycle judgment; use sync-back only for explicit diagnostic/recovery/replay.']
+    }
+};
+export function getSddInstructions(action) {
+    if (!isInstructionAction(action)) {
+        throw new Error(`Unknown instruction action: ${action}`);
+    }
+    return {
+        contract: SDD_INSTRUCTIONS_CONTRACT,
+        version: SDD_VERSION,
+        action,
+        ...INSTRUCTION_PAYLOADS[action]
+    };
+}
+export function renderSddInstructions(payload) {
+    return [
+        `${payload.action}: ${payload.summary}`,
+        '',
+        'Required commands:',
+        ...payload.requiredCommands.map((command) => `- ${command}`),
+        '',
+        'Forbidden side effects:',
+        ...payload.forbiddenSideEffects.map((effect) => `- ${effect}`),
+        '',
+        'Next steps:',
+        ...payload.nextSteps.map((step) => `- ${step}`)
+    ].join('\n');
+}
+function isInstructionAction(action) {
+    return action === 'overview' || action === 'init' || action === 'doctor' || action === 'update' || action === 'spec' || action === 'plan' || action === 'tasks' || action === 'verifies' || action === 'test' || action === 'do' || action === 'verify' || action === 'sync-back' || action === 'ship' || action === 'run-task' || action === 'verify-task';
+}
+//# sourceMappingURL=instructions.js.map

package/packages/core/dist/instructions.js.map

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

package/packages/core/dist/lifecycle/decision-gate.d.ts

@@ -0,0 +1,39 @@
+import { LEGACY_LIFECYCLE_DECISION_CONTRACT, LIFECYCLE_DECISION_CONTRACT, LIFECYCLE_DECISION_VERSION } from '../contracts.js';
+import type { RunState } from '../run-state/model.js';
+import type { LifecycleDecisionSignals } from './risk-signals.js';
+export type LifecycleProfile = 'direct' | 'compact' | 'full' | 'research';
+export type LifecycleConfidence = 'high' | 'medium' | 'low';
+export type LifecycleAutonomyCeiling = 'direct_execution_allowed' | 'compact_boundary_only' | 'full_sdd_with_checkpoint' | 'research_before_implementation';
+export interface LifecycleDecisionRecord {
+    contract: typeof LIFECYCLE_DECISION_CONTRACT | typeof LEGACY_LIFECYCLE_DECISION_CONTRACT;
+    version?: typeof LIFECYCLE_DECISION_VERSION;
+    model_version: string;
+    input_summary: Record<string, unknown>;
+    decision: {
+        profile: LifecycleProfile | null;
+        confidence: LifecycleConfidence | null;
+        hard_gate_hits: string[];
+        required_stages: string[];
+        skipped_stages: string[];
+        human_checkpoint_required: boolean;
+    };
+    reasons: string[];
+    escalation_triggers: string[];
+    downgrade_reason: string | null;
+    audit: {
+        decided_at: string | null;
+        decided_by: 'command' | 'runtime' | 'user_override' | null;
+        policy_version: string;
+        source_artifacts: string[];
+    };
+}
+export interface LifecycleDecisionGateResult {
+    record: LifecycleDecisionRecord;
+    checkpointRequired: boolean;
+    boundaries: string[];
+    autonomyCeiling: LifecycleAutonomyCeiling;
+}
+export declare function evaluateLifecycleDecisionGate(input?: Partial<LifecycleDecisionSignals>, decidedAt?: Date): LifecycleDecisionGateResult;
+export declare function recordLifecycleDecision(projectRoot: string, runId: string, record: LifecycleDecisionRecord): Promise<RunState>;
+export declare function emptyLifecycleDecisionRecord(): LifecycleDecisionRecord;
+export declare function lifecycleAutonomyCeiling(record: LifecycleDecisionRecord): LifecycleAutonomyCeiling;

package/packages/core/dist/lifecycle/decision-gate.js

@@ -0,0 +1,319 @@
+import { LIFECYCLE_DECISION_CONTRACT, LIFECYCLE_DECISION_VERSION } from '../contracts.js';
+import { appendEvent } from '../run-state/events.js';
+import { readRunState, writeRunState } from '../run-state/run-state.js';
+const FULL_PROFILE_HARD_GATES = [
+    'security_auth',
+    'database_or_data_loss',
+    'api_schema_contract',
+    'state_machine_concurrency_liveness',
+    'ci_dependency_build_release'
+];
+export function evaluateLifecycleDecisionGate(input = {}, decidedAt = new Date()) {
+    const signals = normalizeLifecycleSignals(input);
+    const hardGateHits = evaluateLifecycleHardGates(signals);
+    const reasons = [];
+    const escalationTriggers = defaultEscalationTriggers();
+    let profile;
+    if (hardGateHits.includes('external_unknown') || hardGateHits.includes('architecture_decision_required')) {
+        profile = 'research';
+        reasons.push('External unknowns or architecture decisions require research before implementation.');
+    }
+    else if (hardGateHits.some((gate) => FULL_PROFILE_HARD_GATES.includes(gate))) {
+        profile = 'full';
+        reasons.push('Hard gate requires full SDD path with explicit spec, plan, tasks, review, and validation evidence.');
+    }
+    else if (signals.impact_confidence === 'low') {
+        profile = signals.can_scout_impact ? 'compact' : 'research';
+        reasons.push(signals.can_scout_impact ? 'Impact confidence is low but can be bounded by scout evidence, so direct is not allowed.' : 'Impact cannot be estimated safely, so research is required.');
+    }
+    else if (signals.acceptance_clarity === 'low' || signals.validation_clarity === 'unclear') {
+        profile = signals.external_unknown ? 'research' : 'compact';
+        reasons.push('Acceptance or validation signals are insufficient for direct execution.');
+    }
+    else if (matchesDirectWhitelist(signals, hardGateHits)) {
+        profile = 'direct';
+        reasons.push('All direct whitelist conditions hold: clear intent, clear acceptance, high impact confidence, no risk tags, reversible change, and cheap local validation.');
+    }
+    else if (isBoundedCompactChange(signals)) {
+        profile = 'compact';
+        reasons.push('Change is bounded but needs lightweight task boundary or validation context.');
+    }
+    else {
+        profile = 'full';
+        reasons.push('Signals exceed compact boundary or require multi-step SDD evidence.');
+    }
+    if (hardGateHits.length > 0) {
+        reasons.push(`Hard gates hit: ${hardGateHits.join(', ')}.`);
+    }
+    if (signals.policy_hits.length > 0) {
+        reasons.push(`Policy hits require checkpoint attention: ${signals.policy_hits.join(', ')}.`);
+    }
+    if (signals.permission_required.length > 0) {
+        reasons.push(`Permissions require explicit user/Claude Code confirmation: ${signals.permission_required.join(', ')}.`);
+    }
+    const confidence = estimateLifecycleConfidence(signals, hardGateHits);
+    const checkpointRequired = signals.human_checkpoint_required || hardGateHits.includes('database_or_data_loss') || signals.reversibility === 'irreversible' || signals.policy_hits.length > 0 || signals.permission_required.length > 0 || (confidence === 'low' && profile !== 'research');
+    const record = {
+        contract: LIFECYCLE_DECISION_CONTRACT,
+        version: LIFECYCLE_DECISION_VERSION,
+        model_version: 'phase1.0-final',
+        input_summary: {
+            intent_clarity: signals.intent_clarity,
+            acceptance_clarity: signals.acceptance_clarity,
+            estimated_change_size: signals.estimated_change_size,
+            task_count_estimate: signals.task_count_estimate,
+            file_count_estimate: signals.file_count_estimate,
+            impact_surface: signals.affected_layers,
+            affected_contracts: signals.affected_contracts,
+            dependency_fanout: signals.dependency_fanout,
+            impact_confidence: signals.impact_confidence,
+            risk_tags: signals.risk_tags,
+            reversibility: signals.reversibility,
+            validation_clarity: signals.validation_clarity,
+            validation_available: signals.validation_available,
+            validation_cost: signals.validation_cost,
+            orchestration_uncertainty: signals.orchestration_uncertainty,
+            policy_hits: signals.policy_hits,
+            permission_required: signals.permission_required
+        },
+        decision: {
+            profile,
+            confidence,
+            hard_gate_hits: hardGateHits,
+            required_stages: requiredStagesForProfile(profile),
+            skipped_stages: skippedStagesForProfile(profile),
+            human_checkpoint_required: checkpointRequired
+        },
+        reasons,
+        escalation_triggers: escalationTriggers,
+        downgrade_reason: null,
+        audit: {
+            decided_at: decidedAt.toISOString(),
+            decided_by: 'command',
+            policy_version: 'phase1.0-final',
+            source_artifacts: uniqueStrings(['docs/architecture/lifecycle-decision-model.md', ...signals.source_artifacts])
+        }
+    };
+    return {
+        record,
+        checkpointRequired,
+        boundaries: commandIntegrationBoundaries(profile),
+        autonomyCeiling: lifecycleAutonomyCeiling(record)
+    };
+}
+export async function recordLifecycleDecision(projectRoot, runId, record) {
+    const state = await readRunState(projectRoot, runId);
+    const nextState = {
+        ...state,
+        lifecycleDecision: record
+    };
+    await writeRunState(projectRoot, nextState);
+    await appendEvent(projectRoot, runId, {
+        event: 'lifecycle_decision_recorded',
+        runId,
+        summary: `Lifecycle decision recorded by Phase 1.7 command gate: ${record.decision.profile ?? 'unknown'} / ${record.decision.confidence ?? 'unknown'}`,
+        data: {
+            contract: record.contract,
+            modelVersion: record.model_version,
+            profile: record.decision.profile,
+            confidence: record.decision.confidence,
+            hardGateHits: record.decision.hard_gate_hits,
+            humanCheckpointRequired: record.decision.human_checkpoint_required
+        }
+    });
+    return readRunState(projectRoot, runId);
+}
+export function emptyLifecycleDecisionRecord() {
+    return {
+        contract: LIFECYCLE_DECISION_CONTRACT,
+        version: LIFECYCLE_DECISION_VERSION,
+        model_version: 'phase1.0-final',
+        input_summary: {},
+        decision: {
+            profile: null,
+            confidence: null,
+            hard_gate_hits: [],
+            required_stages: [],
+            skipped_stages: [],
+            human_checkpoint_required: false
+        },
+        reasons: ['Phase 1.2 records the lifecycle decision contract; Phase 1.7 command gate will populate decision values.'],
+        escalation_triggers: [],
+        downgrade_reason: null,
+        audit: {
+            decided_at: null,
+            decided_by: null,
+            policy_version: 'phase1.0-final',
+            source_artifacts: ['docs/architecture/lifecycle-decision-model.md']
+        }
+    };
+}
+export function lifecycleAutonomyCeiling(record) {
+    const decision = record.decision;
+    if (decision.profile === 'research') {
+        return 'research_before_implementation';
+    }
+    if (decision.profile === 'full' || decision.human_checkpoint_required || decision.hard_gate_hits.some((gate) => FULL_PROFILE_HARD_GATES.includes(gate))) {
+        return 'full_sdd_with_checkpoint';
+    }
+    if (decision.profile === 'compact') {
+        return 'compact_boundary_only';
+    }
+    return 'direct_execution_allowed';
+}
+function normalizeLifecycleSignals(input) {
+    return {
+        intent_clarity: input.intent_clarity ?? 'medium',
+        acceptance_clarity: input.acceptance_clarity ?? 'medium',
+        estimated_change_size: input.estimated_change_size ?? 'small',
+        task_count_estimate: input.task_count_estimate ?? 1,
+        file_count_estimate: input.file_count_estimate ?? 1,
+        affected_layers: input.affected_layers ?? [],
+        affected_contracts: input.affected_contracts ?? [],
+        dependency_fanout: input.dependency_fanout ?? 'local',
+        impact_confidence: input.impact_confidence ?? 'medium',
+        risk_tags: uniqueStrings(input.risk_tags ?? []),
+        reversibility: input.reversibility ?? 'unknown',
+        validation_clarity: input.validation_clarity ?? 'partial',
+        validation_available: input.validation_available ?? false,
+        validation_cost: input.validation_cost ?? 'unknown',
+        policy_hits: uniqueStrings(input.policy_hits ?? []),
+        permission_required: uniqueStrings(input.permission_required ?? []),
+        requires_agents: input.requires_agents ?? false,
+        handoff_count: input.handoff_count ?? 0,
+        artifact_dependency: input.artifact_dependency ?? false,
+        runtime_recovery_need: input.runtime_recovery_need ?? false,
+        orchestration_uncertainty: input.orchestration_uncertainty ?? 'medium',
+        human_checkpoint_required: input.human_checkpoint_required ?? false,
+        approval_reason: input.approval_reason ?? [],
+        source_artifacts: input.source_artifacts ?? [],
+        can_scout_impact: input.can_scout_impact ?? true,
+        architecture_decision_required: input.architecture_decision_required ?? false,
+        external_unknown: input.external_unknown ?? false
+    };
+}
+function evaluateLifecycleHardGates(signals) {
+    const hits = [];
+    const riskText = signals.risk_tags.map((tag) => tag.toLowerCase());
+    if (signals.external_unknown) {
+        hits.push('external_unknown');
+    }
+    if (signals.architecture_decision_required) {
+        hits.push('architecture_decision_required');
+    }
+    if (containsAny(riskText, ['security', 'auth', 'permission', 'credential', 'data_leak', 'privacy'])) {
+        hits.push('security_auth');
+    }
+    if (containsAny(riskText, ['database', 'migration', 'data_loss', 'irreversible', 'schema-data']) || signals.reversibility === 'irreversible') {
+        hits.push('database_or_data_loss');
+    }
+    if (signals.affected_contracts.length > 0 || containsAny(riskText, ['api', 'schema', 'contract'])) {
+        hits.push('api_schema_contract');
+    }
+    if (containsAny(riskText, ['state_machine', 'state-machine', 'concurrency', 'liveness', 'recovery'])) {
+        hits.push('state_machine_concurrency_liveness');
+    }
+    if (containsAny(riskText, ['ci', 'cd', 'dependency', 'build', 'release', 'publish'])) {
+        hits.push('ci_dependency_build_release');
+    }
+    if (signals.impact_confidence === 'low') {
+        hits.push(signals.can_scout_impact ? 'low_impact_confidence_scoutable' : 'low_impact_confidence_unscoutable');
+    }
+    if (signals.acceptance_clarity === 'low' || signals.validation_clarity === 'unclear') {
+        hits.push('unclear_acceptance_or_validation');
+    }
+    if (signals.policy_hits.length > 0 || signals.permission_required.length > 0) {
+        hits.push('policy_or_permission_checkpoint');
+    }
+    return uniqueStrings(hits);
+}
+function matchesDirectWhitelist(signals, hardGateHits) {
+    return signals.intent_clarity === 'high'
+        && signals.acceptance_clarity === 'high'
+        && signals.validation_clarity === 'clear'
+        && signals.validation_available
+        && signals.validation_cost === 'cheap'
+        && signals.impact_confidence === 'high'
+        && signals.risk_tags.length === 0
+        && hardGateHits.length === 0
+        && signals.reversibility === 'reversible'
+        && !signals.requires_agents
+        && signals.handoff_count === 0
+        && !signals.artifact_dependency
+        && !signals.runtime_recovery_need
+        && signals.orchestration_uncertainty === 'low'
+        && signals.file_count_estimate <= 2
+        && signals.task_count_estimate <= 1;
+}
+function isBoundedCompactChange(signals) {
+    return signals.estimated_change_size !== 'large'
+        && signals.task_count_estimate <= 2
+        && signals.file_count_estimate <= 5
+        && signals.dependency_fanout !== 'multi_component'
+        && signals.dependency_fanout !== 'unknown'
+        && signals.impact_confidence !== 'low'
+        && signals.validation_clarity !== 'unclear'
+        && signals.orchestration_uncertainty !== 'high';
+}
+function estimateLifecycleConfidence(signals, hardGateHits) {
+    if (signals.intent_clarity === 'low' || signals.impact_confidence === 'low' || signals.orchestration_uncertainty === 'high' || signals.external_unknown || signals.architecture_decision_required) {
+        return 'low';
+    }
+    if (signals.intent_clarity === 'high' && signals.acceptance_clarity === 'high' && signals.impact_confidence === 'high' && signals.validation_clarity === 'clear' && hardGateHits.length === 0) {
+        return 'high';
+    }
+    return 'medium';
+}
+function requiredStagesForProfile(profile) {
+    if (profile === 'direct') {
+        return ['intent', 'implement', 'minimal-validation'];
+    }
+    if (profile === 'compact') {
+        return ['intent-or-mini-spec', 'task-boundary', 'implement', 'validation'];
+    }
+    if (profile === 'full') {
+        return ['spec', 'plan', 'tasks', 'do', 'verify', 'sync-back-proposal'];
+    }
+    return ['research', 'options', 'decision', 'architecture-artifact', 'implementation-spec'];
+}
+function skippedStagesForProfile(profile) {
+    if (profile === 'direct') {
+        return ['full-spec', 'full-plan', 'full-tasks', 'agent-workflow'];
+    }
+    if (profile === 'compact') {
+        return ['full-spec', 'full-plan'];
+    }
+    if (profile === 'full') {
+        return ['research'];
+    }
+    return ['direct-implementation'];
+}
+function defaultEscalationTriggers() {
+    return [
+        'actual impact exceeds initial estimate',
+        'API/database/security/state-machine/concurrency/build risk appears',
+        'acceptance or validation becomes unclear',
+        'validation fails for non-obvious reasons',
+        'Spec/Plan/Task/Scope/Validation/Environment gap is detected',
+        'required artifact, delegation terminal event, or liveness evidence is missing'
+    ];
+}
+function commandIntegrationBoundaries(profile) {
+    const boundaries = [
+        'Command gate may decide and record lifecycle profile only.',
+        'Command gate must not execute Phase 1.8 task implementation loop.',
+        'Command gate must not launch agents or workflows in Phase 1.7.',
+        'Phase transition still requires checkpoint confirmation.'
+    ];
+    if (profile === 'direct' || profile === 'compact') {
+        boundaries.push('Short path is allowed only within the recorded lifecycle decision; escalation triggers remain active.');
+    }
+    return boundaries;
+}
+function containsAny(values, needles) {
+    return values.some((value) => needles.some((needle) => value.includes(needle)));
+}
+function uniqueStrings(values) {
+    return Array.from(new Set(values.filter((value) => value.length > 0)));
+}
+//# sourceMappingURL=decision-gate.js.map

package/packages/core/dist/lifecycle/decision-gate.js.map

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

package/packages/core/dist/lifecycle/rendering.d.ts

@@ -0,0 +1,2 @@
+import type { LifecycleDecisionGateResult } from './decision-gate.js';
+export declare function renderLifecycleDecisionGate(result: LifecycleDecisionGateResult): string;

package/packages/core/dist/lifecycle/rendering.js

@@ -0,0 +1,27 @@
+export function renderLifecycleDecisionGate(result) {
+    const decision = result.record.decision;
+    const lines = ['Lifecycle decision'];
+    lines.push('');
+    lines.push(lifecycleDecisionSentence(result));
+    lines.push('');
+    lines.push('Why:');
+    lines.push(`- ${result.record.reasons[0] ?? 'Lifecycle signals were evaluated.'}`);
+    lines.push('');
+    lines.push('Next:');
+    lines.push(`- ${decision.required_stages.length > 0 ? `Complete required stages: ${decision.required_stages.join(' -> ')}.` : 'No required stages were selected.'}`);
+    return lines.join('\n');
+}
+function lifecycleDecisionSentence(result) {
+    const decision = result.record.decision;
+    if (decision.profile === 'research') {
+        return 'Research is required before implementation.';
+    }
+    if (decision.human_checkpoint_required) {
+        return 'Lifecycle checkpoint is required.';
+    }
+    if (decision.profile === 'direct') {
+        return 'Direct workflow is allowed.';
+    }
+    return 'Lifecycle workflow was selected.';
+}
+//# sourceMappingURL=rendering.js.map

package/packages/core/dist/lifecycle/rendering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rendering.js","sourceRoot":"","sources":["../../src/lifecycle/rendering.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,2BAA2B,CAAC,MAAmC;IAC7E,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;IACxC,MAAM,KAAK,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnB,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,mCAAmC,EAAE,CAAC,CAAC;IACnF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,6BAA6B,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,mCAAmC,EAAE,CAAC,CAAC;IACrK,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,yBAAyB,CAAC,MAAmC;IACpE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;IACxC,IAAI,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACpC,OAAO,6CAA6C,CAAC;IACvD,CAAC;IACD,IAAI,QAAQ,CAAC,yBAAyB,EAAE,CAAC;QACvC,OAAO,mCAAmC,CAAC;IAC7C,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,6BAA6B,CAAC;IACvC,CAAC;IACD,OAAO,kCAAkC,CAAC;AAC5C,CAAC"}