{ "schemaVersion": 1, "source": "dist/lib/output/index.js#COMMAND_DESCRIPTOR_REGISTRY", "commandCount": 140, "sharedControls": [ "--format", "--detail", "--fields", "--finding-severity", "--limit", "--page-lane", "--page-size", "--cursor", "--output-budget" ], "commands": [ { "command": "about", "capability": "inspection", "primaryCapability": "inspection", "summary": "Reports runtime and package context.", "writeCapable": false, "artifactFamily": "configuration", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reports runtime and package context.", "argv": [ "day-shift", "about", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "about:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "agent", "capability": "read", "primaryCapability": "read", "summary": "Reports automation-agent orientation, command boundaries, and lifecycle guidance.", "writeCapable": false, "artifactFamily": "agent-orientation", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "verbose", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reports automation-agent orientation, command boundaries, and lifecycle guidance.", "argv": [ "day-shift", "agent", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "agent:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "agent context", "capability": "navigation", "primaryCapability": "navigation", "summary": "Returns bounded context for one explicit or stored planning-artifact selection.", "writeCapable": false, "artifactFamily": "agent-orientation", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "selected-artifact", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "artifact", "required": false, "variadic": false, "defaultValue": null, "validation": "Optional existing repository-relative planning artifact.", "valueType": "string" }, { "kind": "option", "name": "session", "required": false, "variadic": false, "defaultValue": "default", "validation": "Validated local selection session name.", "valueType": "string" }, { "kind": "option", "name": "intent", "required": false, "variadic": false, "defaultValue": null, "validation": "Optional printable intent up to 256 characters.", "valueType": "string" }, { "kind": "option", "name": "includeContextPack", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Boolean flag enabling the default-capped relevance-ranked context pack." }, { "kind": "option", "name": "contextPackBudget", "valueType": "integer", "required": false, "variadic": false, "defaultValue": null, "validation": "Integer from 1024 to 65536; requires includeContextPack." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Returns bounded context for one explicit or stored planning-artifact selection.", "argv": [ "day-shift", "agent", "context", "--artifact", ".day-shift/planning/example/task-definition.md", "--format", "json", "--detail", "compact" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": true, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "agent.context:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "agent orient", "capability": "read", "primaryCapability": "read", "summary": "Runs the full agent orientation alias.", "writeCapable": false, "artifactFamily": "agent-orientation", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "verbose", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Runs the full agent orientation alias.", "argv": [ "day-shift", "agent", "orient", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "agent.orient:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "agent remind", "capability": "read", "primaryCapability": "read", "summary": "Runs the correction-focused agent reminder alias.", "writeCapable": false, "artifactFamily": "agent-orientation", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Runs the correction-focused agent reminder alias.", "argv": [ "day-shift", "agent", "remind", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "agent.remind:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "commands", "capability": "inspection", "primaryCapability": "inspection", "summary": "Groups command inventory and command-surface metadata reports.", "writeCapable": false, "artifactFamily": "configuration", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups command inventory and command-surface metadata reports.", "argv": [ "day-shift", "commands", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "commands:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "commands describe", "capability": "inspection", "primaryCapability": "inspection", "summary": "Describes one exact authoritative command descriptor.", "writeCapable": false, "artifactFamily": "configuration", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "argument", "name": "command", "required": true, "variadic": true, "defaultValue": null, "validation": "Exact registered command path.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Describe one command descriptor.", "argv": [ "day-shift", "commands", "describe", "task", "update", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "commands.describe:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "commands inventory", "capability": "inspection", "primaryCapability": "inspection", "summary": "Reports callable command inventory merged with command capability metadata.", "writeCapable": false, "artifactFamily": "configuration", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reports callable command inventory merged with command capability metadata.", "argv": [ "day-shift", "commands", "inventory", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "commands.inventory:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "commands manifest", "capability": "inspection", "primaryCapability": "inspection", "summary": "Generates native tool descriptors from the authoritative command registry.", "writeCapable": false, "artifactFamily": "configuration", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "argument", "name": "command", "required": false, "variadic": true, "defaultValue": null, "validation": "Optional exact registered command path.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Generate one native tool descriptor.", "argv": [ "day-shift", "commands", "manifest", "task", "update", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "commands.manifest:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "commands search", "capability": "navigation", "primaryCapability": "navigation", "summary": "Searches authoritative command descriptors with bounded deterministic results.", "writeCapable": false, "artifactFamily": "configuration", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "argument", "name": "query", "required": true, "variadic": false, "defaultValue": null, "validation": "Non-empty search query.", "valueType": "string" }, { "kind": "option", "name": "maxResults", "required": false, "variadic": false, "defaultValue": 10, "validation": "Integer from 1 to 50.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Search command descriptors by intent or posture.", "argv": [ "day-shift", "commands", "search", "planning", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "commands.search:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "commands validate", "capability": "validation", "primaryCapability": "validation", "summary": "Validates authoritative descriptors against the live command tree and generated tool manifest.", "writeCapable": false, "artifactFamily": "configuration", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Validates authoritative descriptors against the live command tree and generated tool manifest.", "argv": [ "day-shift", "commands", "validate", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "commands.validate:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "completion", "capability": "inspection", "primaryCapability": "inspection", "summary": "Prints shell completion setup guidance.", "writeCapable": false, "artifactFamily": "completion", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Prints shell completion setup guidance.", "argv": [ "day-shift", "completion", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "completion:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "completion complete", "capability": "inspection", "primaryCapability": "inspection", "summary": "Resolves shell completion candidates without executing target commands.", "writeCapable": false, "artifactFamily": "completion", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "shell", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "line", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "cursor", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Resolves shell completion candidates without executing target commands.", "argv": [ "day-shift", "completion", "complete", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "completion.complete:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "completion install", "capability": "install", "primaryCapability": "install", "summary": "Installs Day Shift-managed shell completion integration.", "writeCapable": true, "artifactFamily": "completion", "destinationPosture": "local-install-target", "targetPathPosture": "shell completion integration file", "coordinationScope": "local-installation", "mutationPosture": "installs-local-files", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "shell", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "dryRun", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "force", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Installs Day Shift-managed shell completion integration.", "argv": [ "day-shift", "completion", "install" ] } ], "effects": { "filesystem": "write", "scope": "shell completion integration file", "network": "none", "hostState": "write", "destructive": false, "interactive": false }, "authorization": "host-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "completion.install:installs-local-files", "kind": "installs-local-files", "expected": "Applies the declared installs-local-files transition within local-installation scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared installs-local-files transition is reflected by canonical repository evidence." } ] } }, { "command": "completion script", "capability": "inspection", "primaryCapability": "inspection", "summary": "Prints a sourceable shell completion script.", "writeCapable": false, "artifactFamily": "completion", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "shell", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Prints a sourceable shell completion script.", "argv": [ "day-shift", "completion", "script", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "completion.script:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "completion uninstall", "capability": "cleanup", "primaryCapability": "cleanup", "summary": "Removes Day Shift-managed shell completion integration.", "writeCapable": true, "artifactFamily": "completion", "destinationPosture": "local-install-target", "targetPathPosture": "shell completion integration file", "coordinationScope": "local-installation", "mutationPosture": "prunes-generated-output", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "shell", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "dryRun", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Removes Day Shift-managed shell completion integration.", "argv": [ "day-shift", "completion", "uninstall" ] } ], "effects": { "filesystem": "write", "scope": "shell completion integration file", "network": "none", "hostState": "write", "destructive": false, "interactive": false }, "authorization": "host-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "completion.uninstall:prunes-generated-output", "kind": "prunes-generated-output", "expected": "Applies the declared prunes-generated-output transition within local-installation scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared prunes-generated-output transition is reflected by canonical repository evidence." } ] } }, { "command": "config", "capability": "inspection", "primaryCapability": "inspection", "summary": "Reports resolved Day Shift configuration.", "writeCapable": false, "artifactFamily": "configuration", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reports resolved Day Shift configuration.", "argv": [ "day-shift", "config", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "config:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "config get", "capability": "inspection", "primaryCapability": "inspection", "summary": "Shows resolved configuration values.", "writeCapable": false, "artifactFamily": "configuration", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "argument", "name": "selector", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Shows resolved configuration values.", "argv": [ "day-shift", "config", "get", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "config.get:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "config inventory", "capability": "inspection", "primaryCapability": "inspection", "summary": "Reports catalog-backed configuration inventory without writing files.", "writeCapable": false, "artifactFamily": "configuration", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "licenseFile", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reports catalog-backed configuration inventory without writing files.", "argv": [ "day-shift", "config", "inventory", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "config.inventory:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "config set", "capability": "update", "primaryCapability": "update", "summary": "Sets writable configuration values.", "writeCapable": true, "artifactFamily": "configuration", "destinationPosture": "workspace-metadata", "targetPathPosture": ".day-shift local configuration", "coordinationScope": "workspace", "mutationPosture": "updates-selected-artifact", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "argument", "name": "key", "valueType": "string", "required": true, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "argument", "name": "value", "valueType": "string", "required": true, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Sets writable configuration values.", "argv": [ "day-shift", "config", "set" ] } ], "effects": { "filesystem": "write", "scope": ".day-shift local configuration", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "config.set:updates-selected-artifact", "kind": "updates-selected-artifact", "expected": "Applies the declared updates-selected-artifact transition within workspace scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-selected-artifact transition is reflected by canonical repository evidence." } ] } }, { "command": "doctor", "capability": "inspection", "primaryCapability": "inspection", "summary": "Reports repository-wide or explicitly scoped read-only workspace health findings.", "writeCapable": false, "artifactFamily": "doctor", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "runtimeOnly", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Mutually exclusive runtime/setup-only scope selector." }, { "kind": "option", "name": "artifact", "required": false, "variadic": false, "defaultValue": null, "validation": "Mutually exclusive existing repository-relative planning Markdown artifact.", "valueType": "string" }, { "kind": "option", "name": "planningDirectory", "required": false, "variadic": false, "defaultValue": null, "validation": "Mutually exclusive existing repository-relative directory inside the configured planning root.", "valueType": "string" }, { "kind": "option", "name": "repositoryAudit", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Mutually exclusive explicit repository-wide audit selector; also the default when no selector is supplied." }, { "kind": "option", "name": "action", "required": false, "variadic": false, "defaultValue": null, "validation": "Optional exact authoritative command descriptor identity used to classify current-action blockers.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reports repository-wide or explicitly scoped read-only workspace health findings.", "argv": [ "day-shift", "doctor", "--runtime-only", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "doctor:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "ignore", "capability": "install", "primaryCapability": "install", "summary": "Installs Day Shift ignore rules.", "writeCapable": true, "artifactFamily": "ignore", "destinationPosture": "local-install-target", "targetPathPosture": ".gitignore or local ignore destination", "coordinationScope": "local-installation", "mutationPosture": "installs-local-files", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Installs Day Shift ignore rules.", "argv": [ "day-shift", "ignore" ] } ], "effects": { "filesystem": "write", "scope": ".gitignore or local ignore destination", "network": "none", "hostState": "write", "destructive": false, "interactive": false }, "authorization": "host-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "ignore:installs-local-files", "kind": "installs-local-files", "expected": "Applies the declared installs-local-files transition within local-installation scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared installs-local-files transition is reflected by canonical repository evidence." } ] } }, { "command": "ignore install", "capability": "install", "primaryCapability": "install", "summary": "Installs canonical Day Shift local-only ignore entries.", "writeCapable": true, "artifactFamily": "ignore", "destinationPosture": "local-install-target", "targetPathPosture": ".gitignore or local ignore destination", "coordinationScope": "local-installation", "mutationPosture": "installs-local-files", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "yes", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Installs canonical Day Shift local-only ignore entries.", "argv": [ "day-shift", "ignore", "install" ] } ], "effects": { "filesystem": "write", "scope": ".gitignore or local ignore destination", "network": "none", "hostState": "write", "destructive": false, "interactive": false }, "authorization": "host-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "ignore.install:installs-local-files", "kind": "installs-local-files", "expected": "Applies the declared installs-local-files transition within local-installation scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared installs-local-files transition is reflected by canonical repository evidence." } ] } }, { "command": "implementation-summary", "capability": "inspection", "primaryCapability": "inspection", "summary": "Groups implementation summary build, review, and update surfaces.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups implementation summary build, review, and update surfaces.", "argv": [ "day-shift", "implementation-summary", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "implementation-summary:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "implementation-summary build", "capability": "build", "primaryCapability": "build", "summary": "Builds or refreshes paired implementation summary artifacts.", "writeCapable": true, "artifactFamily": "planning", "destinationPosture": "canonical-artifact", "targetPathPosture": "paired implementation-summary.md", "coordinationScope": "selected-artifact", "mutationPosture": "updates-selected-artifact", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "taskDefinition", "required": true, "variadic": false, "defaultValue": null, "validation": "Repository-relative owning task-definition.md path.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Builds or refreshes paired implementation summary artifacts.", "argv": [ "day-shift", "implementation-summary", "build", "--task-definition", ".day-shift/planning/example/task-definition.md" ] } ], "effects": { "filesystem": "write", "scope": "paired implementation-summary.md", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": true, "idempotency": "operation-defined", "preconditions": [ { "id": "selected-artifact", "description": "A current repository-relative planning artifact selection is available.", "kind": "selection", "required": true } ], "transition": { "id": "implementation-summary.build:updates-selected-artifact", "kind": "updates-selected-artifact", "expected": "Applies the declared updates-selected-artifact transition within selected-artifact scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-selected-artifact transition is reflected by canonical repository evidence." } ] } }, { "command": "implementation-summary review", "capability": "review", "primaryCapability": "review", "summary": "Reviews implementation summary closeout evidence.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "taskDefinition", "required": true, "variadic": false, "defaultValue": null, "validation": "Repository-relative owning task-definition.md path.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reviews implementation summary closeout evidence.", "argv": [ "day-shift", "implementation-summary", "review", "--task-definition", ".day-shift/planning/example/task-definition.md", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "implementation-summary.review:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "implementation-summary update", "capability": "update", "primaryCapability": "update", "summary": "Updates implementation summary metadata.", "writeCapable": true, "artifactFamily": "planning", "destinationPosture": "selected-existing-artifact", "targetPathPosture": "selected implementation summary", "coordinationScope": "selected-artifact", "mutationPosture": "updates-selected-artifact", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "summary", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "activeArtifact", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "field", "valueType": "string", "required": false, "variadic": true, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Updates implementation summary metadata.", "argv": [ "day-shift", "implementation-summary", "update" ] } ], "effects": { "filesystem": "write", "scope": "selected implementation summary", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": true, "idempotency": "operation-defined", "preconditions": [ { "id": "selected-artifact", "description": "A current repository-relative planning artifact selection is available.", "kind": "selection", "required": true } ], "transition": { "id": "implementation-summary.update:updates-selected-artifact", "kind": "updates-selected-artifact", "expected": "Applies the declared updates-selected-artifact transition within selected-artifact scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-selected-artifact transition is reflected by canonical repository evidence." } ] } }, { "command": "init", "capability": "scaffold", "primaryCapability": "scaffold", "summary": "Initializes a Day Shift workspace.", "writeCapable": true, "artifactFamily": "configuration", "destinationPosture": "canonical-artifact", "targetPathPosture": ".day-shift/ workspace scaffold", "coordinationScope": "workspace", "mutationPosture": "creates-artifacts", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "noAgent", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "withoutTemplates", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "dryRun", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "force", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "directory", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "sandboxRunId", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Initializes a Day Shift workspace.", "argv": [ "day-shift", "init" ] } ], "effects": { "filesystem": "write", "scope": ".day-shift/ workspace scaffold", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "init:creates-artifacts", "kind": "creates-artifacts", "expected": "Applies the declared creates-artifacts transition within workspace scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared creates-artifacts transition is reflected by canonical repository evidence." } ] } }, { "command": "license", "capability": "inspection", "primaryCapability": "inspection", "summary": "Groups license install, status, and reminder cleanup surfaces.", "writeCapable": false, "artifactFamily": "license", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups license install, status, and reminder cleanup surfaces.", "argv": [ "day-shift", "license", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "license:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "license cleanup-reminders", "capability": "cleanup", "primaryCapability": "cleanup", "summary": "Cleans obsolete license reminder state.", "writeCapable": true, "artifactFamily": "license", "destinationPosture": "derived-state", "targetPathPosture": "license reminder state", "coordinationScope": "workspace", "mutationPosture": "prunes-generated-output", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "licenseFile", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "dryRun", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Cleans obsolete license reminder state.", "argv": [ "day-shift", "license", "cleanup-reminders" ] } ], "effects": { "filesystem": "write", "scope": "license reminder state", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "license.cleanup-reminders:prunes-generated-output", "kind": "prunes-generated-output", "expected": "Applies the declared prunes-generated-output transition within workspace scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared prunes-generated-output transition is reflected by canonical repository evidence." } ] } }, { "command": "license install", "capability": "install", "primaryCapability": "install", "summary": "Installs a Day Shift license locally.", "writeCapable": true, "artifactFamily": "license", "destinationPosture": "local-install-target", "targetPathPosture": "local license file", "coordinationScope": "local-installation", "mutationPosture": "installs-local-files", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "argument", "name": "license-file", "valueType": "string", "required": true, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Installs a Day Shift license locally.", "argv": [ "day-shift", "license", "install" ] } ], "effects": { "filesystem": "write", "scope": "local license file", "network": "none", "hostState": "write", "destructive": false, "interactive": false }, "authorization": "host-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "license.install:installs-local-files", "kind": "installs-local-files", "expected": "Applies the declared installs-local-files transition within local-installation scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared installs-local-files transition is reflected by canonical repository evidence." } ] } }, { "command": "license status", "capability": "inspection", "primaryCapability": "inspection", "summary": "Inspects local license status and guidance.", "writeCapable": false, "artifactFamily": "license", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "licenseFile", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Inspects local license status and guidance.", "argv": [ "day-shift", "license", "status", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "license.status:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "link", "capability": "inspection", "primaryCapability": "inspection", "summary": "Groups trace-link lifecycle disposition management surfaces.", "writeCapable": false, "artifactFamily": "validation", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups trace-link lifecycle disposition management surfaces.", "argv": [ "day-shift", "link", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "link:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "link disposition", "capability": "inspection", "primaryCapability": "inspection", "summary": "Groups trace-link disposition read and write surfaces.", "writeCapable": false, "artifactFamily": "validation", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups trace-link disposition read and write surfaces.", "argv": [ "day-shift", "link", "disposition", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "link.disposition:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "link disposition add", "capability": "update", "primaryCapability": "update", "summary": "Creates trace-link lifecycle disposition records.", "writeCapable": true, "artifactFamily": "validation", "destinationPosture": "derived-state", "targetPathPosture": ".day-shift/state/trace-link-dispositions.json", "coordinationScope": "workspace", "mutationPosture": "updates-derived-state", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "status", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "target", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "replacementTarget", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "sourceArtifact", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "traceField", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "scope", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "reason", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "format", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Creates trace-link lifecycle disposition records.", "argv": [ "day-shift", "link", "disposition", "add" ] } ], "effects": { "filesystem": "write", "scope": ".day-shift/state/trace-link-dispositions.json", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "link.disposition.add:updates-derived-state", "kind": "updates-derived-state", "expected": "Applies the declared updates-derived-state transition within workspace scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-derived-state transition is reflected by canonical repository evidence." } ] } }, { "command": "link disposition apply", "capability": "migration", "primaryCapability": "migration", "summary": "Applies migrated trace-link disposition updates.", "writeCapable": true, "artifactFamily": "validation", "destinationPosture": "workspace-metadata", "targetPathPosture": "planning trace fields and disposition storage", "coordinationScope": "workspace", "mutationPosture": "applies-migration", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "id", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "target", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "artifact", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "dryRun", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "format", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Applies migrated trace-link disposition updates.", "argv": [ "day-shift", "link", "disposition", "apply" ] } ], "effects": { "filesystem": "write", "scope": "planning trace fields and disposition storage", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "link.disposition.apply:applies-migration", "kind": "applies-migration", "expected": "Applies the declared applies-migration transition within workspace scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared applies-migration transition is reflected by canonical repository evidence." } ] } }, { "command": "link disposition delete", "capability": "update", "primaryCapability": "update", "summary": "Deletes trace-link lifecycle disposition records.", "writeCapable": true, "artifactFamily": "validation", "destinationPosture": "derived-state", "targetPathPosture": ".day-shift/state/trace-link-dispositions.json", "coordinationScope": "workspace", "mutationPosture": "updates-derived-state", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "id", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "target", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "format", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Deletes trace-link lifecycle disposition records.", "argv": [ "day-shift", "link", "disposition", "delete" ] } ], "effects": { "filesystem": "write", "scope": ".day-shift/state/trace-link-dispositions.json", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "link.disposition.delete:updates-derived-state", "kind": "updates-derived-state", "expected": "Applies the declared updates-derived-state transition within workspace scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-derived-state transition is reflected by canonical repository evidence." } ] } }, { "command": "link disposition list", "capability": "inspection", "primaryCapability": "inspection", "summary": "Lists trace-link disposition records without writing files.", "writeCapable": false, "artifactFamily": "validation", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "status", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "format", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Lists trace-link disposition records without writing files.", "argv": [ "day-shift", "link", "disposition", "list", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "link.disposition.list:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "link disposition preview", "capability": "validation", "primaryCapability": "validation", "summary": "Previews affected planning trace links for recorded dispositions without writing files.", "writeCapable": false, "artifactFamily": "validation", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "id", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "target", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "artifact", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "format", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Previews affected planning trace links for recorded dispositions without writing files.", "argv": [ "day-shift", "link", "disposition", "preview", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "link.disposition.preview:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "link disposition show", "capability": "inspection", "primaryCapability": "inspection", "summary": "Shows one trace-link disposition record without writing files.", "writeCapable": false, "artifactFamily": "validation", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "id", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "target", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "format", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Shows one trace-link disposition record without writing files.", "argv": [ "day-shift", "link", "disposition", "show", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "link.disposition.show:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "link disposition update", "capability": "update", "primaryCapability": "update", "summary": "Updates trace-link lifecycle disposition records.", "writeCapable": true, "artifactFamily": "validation", "destinationPosture": "derived-state", "targetPathPosture": ".day-shift/state/trace-link-dispositions.json", "coordinationScope": "workspace", "mutationPosture": "updates-derived-state", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "id", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "target", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "status", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "replacementTarget", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "clearReplacementTarget", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "sourceArtifact", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "traceField", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "scope", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "reason", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "clearReason", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "format", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Updates trace-link lifecycle disposition records.", "argv": [ "day-shift", "link", "disposition", "update" ] } ], "effects": { "filesystem": "write", "scope": ".day-shift/state/trace-link-dispositions.json", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "link.disposition.update:updates-derived-state", "kind": "updates-derived-state", "expected": "Applies the declared updates-derived-state transition within workspace scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-derived-state transition is reflected by canonical repository evidence." } ] } }, { "command": "link materialize", "capability": "materialize", "primaryCapability": "materialize", "summary": "Materializes validated local Markdown body references as clickable navigation links.", "writeCapable": true, "artifactFamily": "planning", "destinationPosture": "selected-existing-artifact", "targetPathPosture": "selected slice, phase, milestone, task, summary, reconciliation, or planning directory Markdown body references", "coordinationScope": "selected-artifact", "mutationPosture": "updates-selected-artifact", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "scope", "required": false, "variadic": false, "defaultValue": "planning", "validation": "Currently planning.", "valueType": "string" }, { "kind": "option", "name": "artifact", "required": true, "variadic": false, "defaultValue": null, "validation": "Repository-relative selected Markdown artifact or directory.", "valueType": "string" }, { "kind": "option", "name": "dryRun", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Preview candidates without writing." }, { "kind": "option", "name": "write", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Apply safe selected-artifact materialization." }, { "kind": "option", "name": "format", "required": false, "variadic": false, "defaultValue": "text", "validation": "text or json.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Materializes validated local Markdown body references as clickable navigation links.", "argv": [ "day-shift", "link", "materialize", "--dry-run", "--artifact", ".day-shift/planning/example/phase-overview.md", "--format", "json" ] } ], "effects": { "filesystem": "write", "scope": "selected slice, phase, milestone, task, summary, reconciliation, or planning directory Markdown body references", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": true, "idempotency": "operation-defined", "preconditions": [ { "id": "selected-artifact", "description": "A current repository-relative planning artifact selection is available.", "kind": "selection", "required": true } ], "transition": { "id": "link.materialize:updates-selected-artifact", "kind": "updates-selected-artifact", "expected": "Applies the declared updates-selected-artifact transition within selected-artifact scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-selected-artifact transition is reflected by canonical repository evidence." } ] } }, { "command": "manifest", "capability": "inspection", "primaryCapability": "inspection", "summary": "Groups manifest update surfaces.", "writeCapable": false, "artifactFamily": "manifest", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups manifest update surfaces.", "argv": [ "day-shift", "manifest", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "manifest:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "manifest update", "capability": "update", "primaryCapability": "update", "summary": "Updates prompt or template manifest metadata.", "writeCapable": true, "artifactFamily": "manifest", "destinationPosture": "selected-existing-artifact", "targetPathPosture": "selected prompt or template manifest", "coordinationScope": "selected-artifact", "mutationPosture": "updates-selected-artifact", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "manifest", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "field", "valueType": "string", "required": false, "variadic": true, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Updates prompt or template manifest metadata.", "argv": [ "day-shift", "manifest", "update" ] } ], "effects": { "filesystem": "write", "scope": "selected prompt or template manifest", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": true, "idempotency": "operation-defined", "preconditions": [ { "id": "selected-artifact", "description": "A current repository-relative planning artifact selection is available.", "kind": "selection", "required": true } ], "transition": { "id": "manifest.update:updates-selected-artifact", "kind": "updates-selected-artifact", "expected": "Applies the declared updates-selected-artifact transition within selected-artifact scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-selected-artifact transition is reflected by canonical repository evidence." } ] } }, { "command": "metadata", "capability": "inspection", "primaryCapability": "inspection", "summary": "Groups metadata inventory, validation, update, and sync surfaces.", "writeCapable": false, "artifactFamily": "metadata", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups metadata inventory, validation, update, and sync surfaces.", "argv": [ "day-shift", "metadata", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "metadata:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "metadata inventory", "capability": "inspection", "primaryCapability": "inspection", "summary": "Reports metadata-bearing artifact inventory.", "writeCapable": false, "artifactFamily": "metadata", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "root", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reports metadata-bearing artifact inventory.", "argv": [ "day-shift", "metadata", "inventory", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "metadata.inventory:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "metadata sync-status-from-review", "capability": "sync", "primaryCapability": "sync", "summary": "Synchronizes lifecycle status from completed review evidence.", "writeCapable": true, "artifactFamily": "metadata", "destinationPosture": "selected-existing-artifact", "targetPathPosture": "selected planning artifact", "coordinationScope": "selected-artifact", "mutationPosture": "updates-selected-artifact", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "taskDefinition", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "milestoneOverview", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "phaseOverview", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "activeArtifact", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Synchronizes lifecycle status from completed review evidence.", "argv": [ "day-shift", "metadata", "sync-status-from-review" ] } ], "effects": { "filesystem": "write", "scope": "selected planning artifact", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": true, "idempotency": "operation-defined", "preconditions": [ { "id": "selected-artifact", "description": "A current repository-relative planning artifact selection is available.", "kind": "selection", "required": true } ], "transition": { "id": "metadata.sync-status-from-review:updates-selected-artifact", "kind": "updates-selected-artifact", "expected": "Applies the declared updates-selected-artifact transition within selected-artifact scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-selected-artifact transition is reflected by canonical repository evidence." } ] } }, { "command": "metadata update", "capability": "update", "primaryCapability": "update", "summary": "Updates metadata fields through shared helpers.", "writeCapable": true, "artifactFamily": "metadata", "destinationPosture": "selected-existing-artifact", "targetPathPosture": "selected metadata-bearing artifact", "coordinationScope": "selected-artifact", "mutationPosture": "updates-selected-artifact", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "artifact", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "activeArtifact", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "field", "valueType": "string", "required": false, "variadic": true, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Updates metadata fields through shared helpers.", "argv": [ "day-shift", "metadata", "update" ] } ], "effects": { "filesystem": "write", "scope": "selected metadata-bearing artifact", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": true, "idempotency": "operation-defined", "preconditions": [ { "id": "selected-artifact", "description": "A current repository-relative planning artifact selection is available.", "kind": "selection", "required": true } ], "transition": { "id": "metadata.update:updates-selected-artifact", "kind": "updates-selected-artifact", "expected": "Applies the declared updates-selected-artifact transition within selected-artifact scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-selected-artifact transition is reflected by canonical repository evidence." } ] } }, { "command": "metadata validate-update", "capability": "validation", "primaryCapability": "validation", "summary": "Validates metadata update requests without writing.", "writeCapable": false, "artifactFamily": "metadata", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "artifact", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "activeArtifact", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "field", "valueType": "string", "required": false, "variadic": true, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Validates metadata update requests without writing.", "argv": [ "day-shift", "metadata", "validate-update", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "metadata.validate-update:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "milestone", "capability": "inspection", "primaryCapability": "inspection", "summary": "Groups milestone scaffold, update, and review surfaces.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups milestone scaffold, update, and review surfaces.", "argv": [ "day-shift", "milestone", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "milestone:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "milestone new", "capability": "scaffold", "primaryCapability": "scaffold", "summary": "Creates milestone overview scaffolds.", "writeCapable": true, "artifactFamily": "planning", "destinationPosture": "canonical-artifact", "targetPathPosture": "milestone overview and reconciliation placeholder", "coordinationScope": "planning-layer", "mutationPosture": "creates-artifacts", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "phaseOverview", "required": true, "variadic": false, "defaultValue": null, "validation": "Repository-relative parent phase overview.", "valueType": "string" }, { "kind": "option", "name": "milestoneSlug", "required": false, "variadic": false, "defaultValue": null, "validation": "Declared ordered milestone slug unless fullSet is true.", "valueType": "string" }, { "kind": "option", "name": "fullSet", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Create every declared milestone." }, { "kind": "option", "name": "milestoneTitle", "required": false, "variadic": false, "defaultValue": null, "validation": "Optional explicit H1 title.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Creates milestone overview scaffolds.", "argv": [ "day-shift", "milestone", "new", "--phase-overview", ".day-shift/planning/example/phase-overview.md", "--full-set" ] } ], "effects": { "filesystem": "write", "scope": "milestone overview and reconciliation placeholder", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "milestone.new:creates-artifacts", "kind": "creates-artifacts", "expected": "Applies the declared creates-artifacts transition within planning-layer scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared creates-artifacts transition is reflected by canonical repository evidence." } ] } }, { "command": "milestone review", "capability": "review", "primaryCapability": "review", "summary": "Reviews milestone planning and reconciliation evidence.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "milestoneOverview", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reviews milestone planning and reconciliation evidence.", "argv": [ "day-shift", "milestone", "review", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "milestone.review:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "milestone update", "capability": "update", "primaryCapability": "update", "summary": "Updates milestone overview metadata.", "writeCapable": true, "artifactFamily": "planning", "destinationPosture": "selected-existing-artifact", "targetPathPosture": "selected milestone overview", "coordinationScope": "selected-artifact", "mutationPosture": "updates-selected-artifact", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "milestoneOverview", "required": true, "variadic": false, "defaultValue": null, "validation": "Repository-relative milestone-overview.md path.", "valueType": "string" }, { "kind": "option", "name": "activeArtifact", "required": false, "variadic": false, "defaultValue": null, "validation": "Optional matching active-artifact guard.", "valueType": "string" }, { "kind": "option", "name": "field", "required": true, "variadic": true, "defaultValue": null, "validation": "One or more direct key=value metadata updates.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Updates milestone overview metadata.", "argv": [ "day-shift", "milestone", "update", "--milestone-overview", ".day-shift/planning/example/milestone-overview.md", "--field", "status=completed" ] } ], "effects": { "filesystem": "write", "scope": "selected milestone overview", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": true, "idempotency": "operation-defined", "preconditions": [ { "id": "selected-artifact", "description": "A current repository-relative planning artifact selection is available.", "kind": "selection", "required": true } ], "transition": { "id": "milestone.update:updates-selected-artifact", "kind": "updates-selected-artifact", "expected": "Applies the declared updates-selected-artifact transition within selected-artifact scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-selected-artifact transition is reflected by canonical repository evidence." } ] } }, { "command": "phase", "capability": "inspection", "primaryCapability": "inspection", "summary": "Groups phase scaffold, update, and review surfaces.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups phase scaffold, update, and review surfaces.", "argv": [ "day-shift", "phase", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "phase:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "phase new", "capability": "scaffold", "primaryCapability": "scaffold", "summary": "Creates phase overview scaffolds.", "writeCapable": true, "artifactFamily": "planning", "destinationPosture": "canonical-artifact", "targetPathPosture": "phase overview", "coordinationScope": "planning-layer", "mutationPosture": "creates-artifacts", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "sliceOverview", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "phaseSlug", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "fullSet", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "phaseTitle", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Creates phase overview scaffolds.", "argv": [ "day-shift", "phase", "new" ] } ], "effects": { "filesystem": "write", "scope": "phase overview", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "phase.new:creates-artifacts", "kind": "creates-artifacts", "expected": "Applies the declared creates-artifacts transition within planning-layer scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared creates-artifacts transition is reflected by canonical repository evidence." } ] } }, { "command": "phase review", "capability": "review", "primaryCapability": "review", "summary": "Reviews phase planning evidence.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "phaseOverview", "required": true, "variadic": false, "defaultValue": null, "validation": "Repository-relative phase-overview.md path.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reviews phase planning evidence.", "argv": [ "day-shift", "phase", "review", "--phase-overview", ".day-shift/planning/example/phase-overview.md", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "phase.review:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "phase update", "capability": "update", "primaryCapability": "update", "summary": "Updates phase overview metadata.", "writeCapable": true, "artifactFamily": "planning", "destinationPosture": "selected-existing-artifact", "targetPathPosture": "selected phase overview", "coordinationScope": "selected-artifact", "mutationPosture": "updates-selected-artifact", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "phaseOverview", "required": true, "variadic": false, "defaultValue": null, "validation": "Repository-relative phase-overview.md path.", "valueType": "string" }, { "kind": "option", "name": "activeArtifact", "required": false, "variadic": false, "defaultValue": null, "validation": "Optional matching active-artifact guard.", "valueType": "string" }, { "kind": "option", "name": "field", "required": true, "variadic": true, "defaultValue": null, "validation": "One or more direct key=value metadata updates.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Updates phase overview metadata.", "argv": [ "day-shift", "phase", "update", "--phase-overview", ".day-shift/planning/example/phase-overview.md", "--field", "status=completed" ] } ], "effects": { "filesystem": "write", "scope": "selected phase overview", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": true, "idempotency": "operation-defined", "preconditions": [ { "id": "selected-artifact", "description": "A current repository-relative planning artifact selection is available.", "kind": "selection", "required": true } ], "transition": { "id": "phase.update:updates-selected-artifact", "kind": "updates-selected-artifact", "expected": "Applies the declared updates-selected-artifact transition within selected-artifact scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-selected-artifact transition is reflected by canonical repository evidence." } ] } }, { "command": "planning", "capability": "navigation", "primaryCapability": "navigation", "summary": "Groups planning navigation surfaces.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups planning navigation surfaces.", "argv": [ "day-shift", "planning", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "planning:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "planning gap-report", "capability": "navigation", "primaryCapability": "navigation", "summary": "Reports missing or incomplete planning artifacts.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "scope", "required": false, "variadic": false, "defaultValue": ".day-shift/planning", "validation": "Repository-relative planning artifact or directory.", "valueType": "string" }, { "kind": "option", "name": "artifact", "required": false, "variadic": false, "defaultValue": null, "validation": "Alias for scope.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reports missing or incomplete planning artifacts.", "argv": [ "day-shift", "planning", "gap-report", "--scope", ".day-shift/planning/example/phase-overview.md", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "planning.gap-report:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "planning inventory", "capability": "navigation", "primaryCapability": "navigation", "summary": "Reports planning hierarchy inventory.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "root", "required": false, "variadic": false, "defaultValue": ".day-shift/planning", "validation": "Repository-relative planning root or subdirectory.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reports planning hierarchy inventory.", "argv": [ "day-shift", "planning", "inventory", "--root", ".day-shift/planning", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "planning.inventory:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "planning next-action", "capability": "navigation", "primaryCapability": "navigation", "summary": "Reports the next likely planning action.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "artifact", "required": true, "variadic": false, "defaultValue": null, "validation": "Repository-relative selected planning artifact.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reports the next likely planning action.", "argv": [ "day-shift", "planning", "next-action", "--artifact", ".day-shift/planning/example/phase-overview.md", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "planning.next-action:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "prompt", "capability": "inspection", "primaryCapability": "inspection", "summary": "Groups prompt init, edit, and update surfaces.", "writeCapable": false, "artifactFamily": "prompt", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups prompt init, edit, and update surfaces.", "argv": [ "day-shift", "prompt", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "prompt:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "prompt edit", "capability": "update", "primaryCapability": "update", "summary": "Edits prompt markdown.", "writeCapable": true, "artifactFamily": "prompt", "destinationPosture": "selected-existing-artifact", "targetPathPosture": "selected prompt markdown", "coordinationScope": "selected-artifact", "mutationPosture": "updates-selected-artifact", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "prompt", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Edits prompt markdown.", "argv": [ "day-shift", "prompt", "edit" ] } ], "effects": { "filesystem": "write", "scope": "selected prompt markdown", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": true, "idempotency": "operation-defined", "preconditions": [ { "id": "selected-artifact", "description": "A current repository-relative planning artifact selection is available.", "kind": "selection", "required": true } ], "transition": { "id": "prompt.edit:updates-selected-artifact", "kind": "updates-selected-artifact", "expected": "Applies the declared updates-selected-artifact transition within selected-artifact scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-selected-artifact transition is reflected by canonical repository evidence." } ] } }, { "command": "prompt init", "capability": "scaffold", "primaryCapability": "scaffold", "summary": "Initializes prompt assets.", "writeCapable": true, "artifactFamily": "prompt", "destinationPosture": "canonical-artifact", "targetPathPosture": ".day-shift/prompts/ assets", "coordinationScope": "selected-family", "mutationPosture": "creates-artifacts", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "prompt", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "force", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Initializes prompt assets.", "argv": [ "day-shift", "prompt", "init" ] } ], "effects": { "filesystem": "write", "scope": ".day-shift/prompts/ assets", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "prompt.init:creates-artifacts", "kind": "creates-artifacts", "expected": "Applies the declared creates-artifacts transition within selected-family scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared creates-artifacts transition is reflected by canonical repository evidence." } ] } }, { "command": "prompt update", "capability": "update", "primaryCapability": "update", "summary": "Updates prompt metadata.", "writeCapable": true, "artifactFamily": "prompt", "destinationPosture": "selected-existing-artifact", "targetPathPosture": "selected prompt front matter", "coordinationScope": "selected-artifact", "mutationPosture": "updates-selected-artifact", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "prompt", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "field", "valueType": "string", "required": false, "variadic": true, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Updates prompt metadata.", "argv": [ "day-shift", "prompt", "update" ] } ], "effects": { "filesystem": "write", "scope": "selected prompt front matter", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": true, "idempotency": "operation-defined", "preconditions": [ { "id": "selected-artifact", "description": "A current repository-relative planning artifact selection is available.", "kind": "selection", "required": true } ], "transition": { "id": "prompt.update:updates-selected-artifact", "kind": "updates-selected-artifact", "expected": "Applies the declared updates-selected-artifact transition within selected-artifact scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-selected-artifact transition is reflected by canonical repository evidence." } ] } }, { "command": "reconciliation", "capability": "inspection", "primaryCapability": "inspection", "summary": "Groups reconciliation build, review, and update surfaces.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups reconciliation build, review, and update surfaces.", "argv": [ "day-shift", "reconciliation", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "reconciliation:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "reconciliation build", "capability": "build", "primaryCapability": "build", "summary": "Builds or refreshes milestone reconciliation artifacts.", "writeCapable": true, "artifactFamily": "planning", "destinationPosture": "canonical-artifact", "targetPathPosture": "milestone reconciliation.md", "coordinationScope": "planning-layer", "mutationPosture": "updates-selected-artifact", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "milestoneOverview", "required": false, "variadic": false, "defaultValue": null, "validation": "Repository-relative owning milestone overview.", "valueType": "string" }, { "kind": "option", "name": "taskDefinition", "required": false, "variadic": false, "defaultValue": null, "validation": "Explicit task-level exception owner.", "valueType": "string" }, { "kind": "option", "name": "rationale", "required": false, "variadic": false, "defaultValue": null, "validation": "Required for task-level reconciliation.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Builds or refreshes milestone reconciliation artifacts.", "argv": [ "day-shift", "reconciliation", "build", "--milestone-overview", ".day-shift/planning/example/milestone-overview.md" ] } ], "effects": { "filesystem": "write", "scope": "milestone reconciliation.md", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "reconciliation.build:updates-selected-artifact", "kind": "updates-selected-artifact", "expected": "Applies the declared updates-selected-artifact transition within planning-layer scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-selected-artifact transition is reflected by canonical repository evidence." } ] } }, { "command": "reconciliation review", "capability": "review", "primaryCapability": "review", "summary": "Reviews milestone reconciliation evidence.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "milestoneOverview", "required": false, "variadic": false, "defaultValue": null, "validation": "Repository-relative owning milestone overview.", "valueType": "string" }, { "kind": "option", "name": "taskDefinition", "required": false, "variadic": false, "defaultValue": null, "validation": "Explicit task-level exception owner.", "valueType": "string" }, { "kind": "option", "name": "rationale", "required": false, "variadic": false, "defaultValue": null, "validation": "Required for task-level reconciliation.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reviews milestone reconciliation evidence.", "argv": [ "day-shift", "reconciliation", "review", "--milestone-overview", ".day-shift/planning/example/milestone-overview.md", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "reconciliation.review:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "reconciliation update", "capability": "update", "primaryCapability": "update", "summary": "Updates reconciliation metadata.", "writeCapable": true, "artifactFamily": "planning", "destinationPosture": "selected-existing-artifact", "targetPathPosture": "selected reconciliation artifact", "coordinationScope": "selected-artifact", "mutationPosture": "updates-selected-artifact", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "reconciliation", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "activeArtifact", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "field", "valueType": "string", "required": false, "variadic": true, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Updates reconciliation metadata.", "argv": [ "day-shift", "reconciliation", "update" ] } ], "effects": { "filesystem": "write", "scope": "selected reconciliation artifact", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": true, "idempotency": "operation-defined", "preconditions": [ { "id": "selected-artifact", "description": "A current repository-relative planning artifact selection is available.", "kind": "selection", "required": true } ], "transition": { "id": "reconciliation.update:updates-selected-artifact", "kind": "updates-selected-artifact", "expected": "Applies the declared updates-selected-artifact transition within selected-artifact scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-selected-artifact transition is reflected by canonical repository evidence." } ] } }, { "command": "release", "capability": "inspection", "primaryCapability": "inspection", "summary": "Groups release validation and generated-output surfaces.", "writeCapable": false, "artifactFamily": "release", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups release validation and generated-output surfaces.", "argv": [ "day-shift", "release", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "release:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "release archive", "capability": "release", "primaryCapability": "release", "summary": "Generates release archives.", "writeCapable": true, "artifactFamily": "release", "destinationPosture": "generated-output", "targetPathPosture": "release archives", "coordinationScope": "release-output", "mutationPosture": "materializes-assets", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "releaseVersion", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "outputDir", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "dryRun", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Generates release archives.", "argv": [ "day-shift", "release", "archive" ] } ], "effects": { "filesystem": "write", "scope": "release archives", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "release.archive:materializes-assets", "kind": "materializes-assets", "expected": "Applies the declared materializes-assets transition within release-output scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared materializes-assets transition is reflected by canonical repository evidence." } ] } }, { "command": "release build", "capability": "release", "primaryCapability": "release", "summary": "Builds local release output.", "writeCapable": true, "artifactFamily": "release", "destinationPosture": "generated-output", "targetPathPosture": "release//", "coordinationScope": "release-output", "mutationPosture": "materializes-assets", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "releaseVersion", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "commandName", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "outputDir", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "dryRun", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "dirty", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Builds local release output.", "argv": [ "day-shift", "release", "build" ] } ], "effects": { "filesystem": "write", "scope": "release//", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "release.build:materializes-assets", "kind": "materializes-assets", "expected": "Applies the declared materializes-assets transition within release-output scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared materializes-assets transition is reflected by canonical repository evidence." } ] } }, { "command": "release check", "capability": "validation", "primaryCapability": "validation", "summary": "Checks local release inputs and staged outputs.", "writeCapable": false, "artifactFamily": "release", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "releaseVersion", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "commandName", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "outputDir", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Checks local release inputs and staged outputs.", "argv": [ "day-shift", "release", "check", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "release.check:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "release checksum", "capability": "release", "primaryCapability": "release", "summary": "Generates release checksums.", "writeCapable": true, "artifactFamily": "release", "destinationPosture": "generated-output", "targetPathPosture": "release checksums", "coordinationScope": "release-output", "mutationPosture": "materializes-assets", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "releaseVersion", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "outputDir", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "dryRun", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Generates release checksums.", "argv": [ "day-shift", "release", "checksum" ] } ], "effects": { "filesystem": "write", "scope": "release checksums", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "release.checksum:materializes-assets", "kind": "materializes-assets", "expected": "Applies the declared materializes-assets transition within release-output scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared materializes-assets transition is reflected by canonical repository evidence." } ] } }, { "command": "release cleanup", "capability": "cleanup", "primaryCapability": "cleanup", "summary": "Cleans generated release output.", "writeCapable": true, "artifactFamily": "release", "destinationPosture": "generated-output", "targetPathPosture": "release output directory", "coordinationScope": "release-output", "mutationPosture": "prunes-generated-output", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "outputDir", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "confirm", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "dryRun", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Cleans generated release output.", "argv": [ "day-shift", "release", "cleanup" ] } ], "effects": { "filesystem": "write", "scope": "release output directory", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "release.cleanup:prunes-generated-output", "kind": "prunes-generated-output", "expected": "Applies the declared prunes-generated-output transition within release-output scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared prunes-generated-output transition is reflected by canonical repository evidence." } ] } }, { "command": "release installer", "capability": "release", "primaryCapability": "release", "summary": "Generates release installer assets.", "writeCapable": true, "artifactFamily": "release", "destinationPosture": "generated-output", "targetPathPosture": "release installer assets", "coordinationScope": "release-output", "mutationPosture": "materializes-assets", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "releaseVersion", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "commandName", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "outputDir", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "dryRun", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Generates release installer assets.", "argv": [ "day-shift", "release", "installer" ] } ], "effects": { "filesystem": "write", "scope": "release installer assets", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "release.installer:materializes-assets", "kind": "materializes-assets", "expected": "Applies the declared materializes-assets transition within release-output scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared materializes-assets transition is reflected by canonical repository evidence." } ] } }, { "command": "release manifest", "capability": "release", "primaryCapability": "release", "summary": "Generates release manifest output.", "writeCapable": true, "artifactFamily": "release", "destinationPosture": "generated-output", "targetPathPosture": "release manifest", "coordinationScope": "release-output", "mutationPosture": "materializes-assets", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "releaseVersion", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "commandName", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "outputDir", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "dryRun", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Generates release manifest output.", "argv": [ "day-shift", "release", "manifest" ] } ], "effects": { "filesystem": "write", "scope": "release manifest", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "release.manifest:materializes-assets", "kind": "materializes-assets", "expected": "Applies the declared materializes-assets transition within release-output scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared materializes-assets transition is reflected by canonical repository evidence." } ] } }, { "command": "release notes", "capability": "release", "primaryCapability": "release", "summary": "Generates release notes draft output.", "writeCapable": true, "artifactFamily": "release", "destinationPosture": "generated-output", "targetPathPosture": "release notes draft", "coordinationScope": "release-output", "mutationPosture": "materializes-assets", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "releaseVersion", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "commandName", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "outputDir", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "dryRun", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Generates release notes draft output.", "argv": [ "day-shift", "release", "notes" ] } ], "effects": { "filesystem": "write", "scope": "release notes draft", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "release.notes:materializes-assets", "kind": "materializes-assets", "expected": "Applies the declared materializes-assets transition within release-output scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared materializes-assets transition is reflected by canonical repository evidence." } ] } }, { "command": "release retention", "capability": "cleanup", "primaryCapability": "cleanup", "summary": "Prunes old release output according to retention policy.", "writeCapable": true, "artifactFamily": "release", "destinationPosture": "generated-output", "targetPathPosture": "release output retention targets", "coordinationScope": "release-output", "mutationPosture": "prunes-generated-output", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "releaseVersion", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "outputDir", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "keep", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "dryRun", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Prunes old release output according to retention policy.", "argv": [ "day-shift", "release", "retention" ] } ], "effects": { "filesystem": "write", "scope": "release output retention targets", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "release.retention:prunes-generated-output", "kind": "prunes-generated-output", "expected": "Applies the declared prunes-generated-output transition within release-output scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared prunes-generated-output transition is reflected by canonical repository evidence." } ] } }, { "command": "resume", "capability": "inspection", "primaryCapability": "inspection", "summary": "Groups evidence-backed local resume capsule lifecycle surfaces.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups evidence-backed local resume capsule lifecycle surfaces.", "argv": [ "day-shift", "resume", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "resume:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "resume cleanup", "capability": "cleanup", "primaryCapability": "cleanup", "summary": "Clears stale or expired capsule state while preserving fresh or absent state.", "writeCapable": true, "artifactFamily": "planning", "destinationPosture": "derived-state", "targetPathPosture": "user-local resume capsule state", "coordinationScope": "workspace", "mutationPosture": "updates-derived-state", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "session", "required": false, "variadic": false, "defaultValue": "default", "validation": "Validated local session name.", "valueType": "string" }, { "kind": "option", "name": "ifMatch", "required": false, "variadic": false, "defaultValue": null, "validation": "Opaque token from resume inspect; required to clear stale state.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Clears stale or expired capsule state while preserving fresh or absent state.", "argv": [ "day-shift", "resume", "cleanup", "--session", "default", "--if-match", "" ] } ], "effects": { "filesystem": "write", "scope": "user-local resume capsule state", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "host-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "resume.cleanup:updates-derived-state", "kind": "updates-derived-state", "expected": "Applies the declared updates-derived-state transition within workspace scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-derived-state transition is reflected by canonical repository evidence." } ] } }, { "command": "resume clear", "capability": "cleanup", "primaryCapability": "cleanup", "summary": "Clears one named resume capsule.", "writeCapable": true, "artifactFamily": "planning", "destinationPosture": "derived-state", "targetPathPosture": "user-local resume capsule state", "coordinationScope": "workspace", "mutationPosture": "updates-derived-state", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "session", "required": false, "variadic": false, "defaultValue": "default", "validation": "Validated local session name.", "valueType": "string" }, { "kind": "option", "name": "ifMatch", "required": false, "variadic": false, "defaultValue": null, "validation": "Opaque token from resume inspect; required when state exists.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Clears one named resume capsule.", "argv": [ "day-shift", "resume", "clear", "--session", "default", "--if-match", "" ] } ], "effects": { "filesystem": "write", "scope": "user-local resume capsule state", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "host-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "resume.clear:updates-derived-state", "kind": "updates-derived-state", "expected": "Applies the declared updates-derived-state transition within workspace scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-derived-state transition is reflected by canonical repository evidence." } ] } }, { "command": "resume create", "capability": "update", "primaryCapability": "update", "summary": "Creates or replaces one evidence-backed resume capsule.", "writeCapable": true, "artifactFamily": "planning", "destinationPosture": "derived-state", "targetPathPosture": "user-local resume capsule state", "coordinationScope": "workspace", "mutationPosture": "updates-derived-state", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "artifact", "required": true, "variadic": false, "defaultValue": null, "validation": "Existing repository-relative planning artifact.", "valueType": "string" }, { "kind": "option", "name": "session", "required": false, "variadic": false, "defaultValue": "default", "validation": "Validated local session name.", "valueType": "string" }, { "kind": "option", "name": "ifMatch", "required": false, "variadic": false, "defaultValue": null, "validation": "Opaque token from resume inspect; required to replace existing state.", "valueType": "string" }, { "kind": "option", "name": "completedAction", "required": false, "variadic": true, "defaultValue": [], "validation": "Historical completed action identifiers.", "valueType": "string" }, { "kind": "option", "name": "evidence", "required": false, "variadic": true, "defaultValue": [], "validation": "Repository-relative evidence paths to hash.", "valueType": "string" }, { "kind": "option", "name": "postcondition", "required": false, "variadic": true, "defaultValue": [], "validation": "Repository-relative postcondition evidence paths to hash.", "valueType": "string" }, { "kind": "option", "name": "blocker", "required": false, "variadic": true, "defaultValue": [], "validation": "Unresolved blocker evidence to preserve.", "valueType": "string" }, { "kind": "option", "name": "expiresInHours", "required": false, "variadic": false, "defaultValue": 24, "validation": "Positive expiry duration in hours.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Creates or replaces one evidence-backed resume capsule.", "argv": [ "day-shift", "resume", "create", "--artifact", ".day-shift/planning/example/task-definition.md" ] } ], "effects": { "filesystem": "write", "scope": "user-local resume capsule state", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "host-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "resume.create:updates-derived-state", "kind": "updates-derived-state", "expected": "Applies the declared updates-derived-state transition within workspace scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-derived-state transition is reflected by canonical repository evidence." } ] } }, { "command": "resume inspect", "capability": "inspection", "primaryCapability": "inspection", "summary": "Inspects capsule freshness and conflicts without writing state.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "artifact", "required": false, "variadic": false, "defaultValue": null, "validation": "Optional explicit artifact identity.", "valueType": "string" }, { "kind": "option", "name": "session", "required": false, "variadic": false, "defaultValue": "default", "validation": "Validated local session name.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Inspects capsule freshness and conflicts without writing state.", "argv": [ "day-shift", "resume", "inspect", "--session", "default", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "resume.inspect:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "resume resume", "capability": "navigation", "primaryCapability": "navigation", "summary": "Revalidates a fresh capsule and reports current action legality without writes.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "artifact", "required": false, "variadic": false, "defaultValue": null, "validation": "Optional explicit artifact identity; conflicts fail closed.", "valueType": "string" }, { "kind": "option", "name": "session", "required": false, "variadic": false, "defaultValue": "default", "validation": "Validated local session name.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Revalidates a fresh capsule and reports current action legality without writes.", "argv": [ "day-shift", "resume", "resume", "--session", "default", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "resume.resume:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "slice", "capability": "inspection", "primaryCapability": "inspection", "summary": "Groups slice scaffold, update, and review surfaces.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups slice scaffold, update, and review surfaces.", "argv": [ "day-shift", "slice", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "slice:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "slice new", "capability": "scaffold", "primaryCapability": "scaffold", "summary": "Creates a slice overview scaffold.", "writeCapable": true, "artifactFamily": "planning", "destinationPosture": "canonical-artifact", "targetPathPosture": "slice overview and companion directories", "coordinationScope": "planning-layer", "mutationPosture": "creates-artifacts", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "specId", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "sliceId", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Creates a slice overview scaffold.", "argv": [ "day-shift", "slice", "new" ] } ], "effects": { "filesystem": "write", "scope": "slice overview and companion directories", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "slice.new:creates-artifacts", "kind": "creates-artifacts", "expected": "Applies the declared creates-artifacts transition within planning-layer scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared creates-artifacts transition is reflected by canonical repository evidence." } ] } }, { "command": "slice review", "capability": "review", "primaryCapability": "review", "summary": "Reviews slice planning evidence.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reviews slice planning evidence.", "argv": [ "day-shift", "slice", "review", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "slice.review:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "slice update", "capability": "update", "primaryCapability": "update", "summary": "Updates slice overview metadata.", "writeCapable": true, "artifactFamily": "planning", "destinationPosture": "selected-existing-artifact", "targetPathPosture": "selected slice overview", "coordinationScope": "selected-artifact", "mutationPosture": "updates-selected-artifact", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "sliceOverview", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "activeArtifact", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "field", "valueType": "string", "required": false, "variadic": true, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Updates slice overview metadata.", "argv": [ "day-shift", "slice", "update" ] } ], "effects": { "filesystem": "write", "scope": "selected slice overview", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": true, "idempotency": "operation-defined", "preconditions": [ { "id": "selected-artifact", "description": "A current repository-relative planning artifact selection is available.", "kind": "selection", "required": true } ], "transition": { "id": "slice.update:updates-selected-artifact", "kind": "updates-selected-artifact", "expected": "Applies the declared updates-selected-artifact transition within selected-artifact scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-selected-artifact transition is reflected by canonical repository evidence." } ] } }, { "command": "spec", "capability": "inspection", "primaryCapability": "inspection", "summary": "Groups spec registry read and write surfaces.", "writeCapable": false, "artifactFamily": "spec-registry", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups spec registry read and write surfaces.", "argv": [ "day-shift", "spec", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "spec:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "spec add", "capability": "update", "primaryCapability": "update", "summary": "Adds a spec registry entry.", "writeCapable": true, "artifactFamily": "spec-registry", "destinationPosture": "selected-existing-artifact", "targetPathPosture": ".day-shift/specs/index.json", "coordinationScope": "selected-family", "mutationPosture": "updates-selected-artifact", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "entryJson", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "entryFile", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Adds a spec registry entry.", "argv": [ "day-shift", "spec", "add" ] } ], "effects": { "filesystem": "write", "scope": ".day-shift/specs/index.json", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "spec.add:updates-selected-artifact", "kind": "updates-selected-artifact", "expected": "Applies the declared updates-selected-artifact transition within selected-family scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-selected-artifact transition is reflected by canonical repository evidence." } ] } }, { "command": "spec archive", "capability": "update", "primaryCapability": "update", "summary": "Archives a spec registry entry.", "writeCapable": true, "artifactFamily": "spec-registry", "destinationPosture": "selected-existing-artifact", "targetPathPosture": ".day-shift/specs/index.json", "coordinationScope": "selected-family", "mutationPosture": "updates-selected-artifact", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "argument", "name": "id", "valueType": "string", "required": true, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Archives a spec registry entry.", "argv": [ "day-shift", "spec", "archive" ] } ], "effects": { "filesystem": "write", "scope": ".day-shift/specs/index.json", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "spec.archive:updates-selected-artifact", "kind": "updates-selected-artifact", "expected": "Applies the declared updates-selected-artifact transition within selected-family scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-selected-artifact transition is reflected by canonical repository evidence." } ] } }, { "command": "spec list", "capability": "list", "primaryCapability": "list", "summary": "Lists registered specs.", "writeCapable": false, "artifactFamily": "spec-registry", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "includeArchived", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Lists registered specs.", "argv": [ "day-shift", "spec", "list", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "spec.list:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "spec search", "capability": "navigation", "primaryCapability": "navigation", "summary": "Searches registered specs.", "writeCapable": false, "artifactFamily": "spec-registry", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "argument", "name": "query", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "includeArchived", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Searches registered specs.", "argv": [ "day-shift", "spec", "search", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "spec.search:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "spec update", "capability": "update", "primaryCapability": "update", "summary": "Updates mutable spec registry fields.", "writeCapable": true, "artifactFamily": "spec-registry", "destinationPosture": "selected-existing-artifact", "targetPathPosture": ".day-shift/specs/index.json", "coordinationScope": "selected-family", "mutationPosture": "updates-selected-artifact", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "specId", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "field", "valueType": "string", "required": false, "variadic": true, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Updates mutable spec registry fields.", "argv": [ "day-shift", "spec", "update" ] } ], "effects": { "filesystem": "write", "scope": ".day-shift/specs/index.json", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "spec.update:updates-selected-artifact", "kind": "updates-selected-artifact", "expected": "Applies the declared updates-selected-artifact transition within selected-family scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-selected-artifact transition is reflected by canonical repository evidence." } ] } }, { "command": "structural-pressure", "capability": "inspection", "primaryCapability": "inspection", "summary": "Groups structural-pressure report and sync surfaces.", "writeCapable": false, "artifactFamily": "structural-pressure", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups structural-pressure report and sync surfaces.", "argv": [ "day-shift", "structural-pressure", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "structural-pressure:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "structural-pressure report", "capability": "review", "primaryCapability": "review", "summary": "Reports structural pressure evidence.", "writeCapable": false, "artifactFamily": "structural-pressure", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "path", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reports structural pressure evidence.", "argv": [ "day-shift", "structural-pressure", "report", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "structural-pressure.report:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "structural-pressure sync", "capability": "sync", "primaryCapability": "sync", "summary": "Synchronizes structural-pressure derived state.", "writeCapable": true, "artifactFamily": "structural-pressure", "destinationPosture": "derived-state", "targetPathPosture": ".day-shift/state/structural-pressure.json", "coordinationScope": "workspace", "mutationPosture": "updates-derived-state", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "milestoneReconciliation", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Synchronizes structural-pressure derived state.", "argv": [ "day-shift", "structural-pressure", "sync" ] } ], "effects": { "filesystem": "write", "scope": ".day-shift/state/structural-pressure.json", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "structural-pressure.sync:updates-derived-state", "kind": "updates-derived-state", "expected": "Applies the declared updates-derived-state transition within workspace scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-derived-state transition is reflected by canonical repository evidence." } ] } }, { "command": "task", "capability": "inspection", "primaryCapability": "inspection", "summary": "Groups task scaffold, promote, update, readiness, and review surfaces.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups task scaffold, promote, update, readiness, and review surfaces.", "argv": [ "day-shift", "task", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "task:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "task new", "capability": "scaffold", "primaryCapability": "scaffold", "summary": "Creates task artifacts.", "writeCapable": true, "artifactFamily": "planning", "destinationPosture": "canonical-artifact", "targetPathPosture": "task directory with task definition and implementation summary", "coordinationScope": "planning-layer", "mutationPosture": "creates-artifacts", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "milestoneOverview", "required": false, "variadic": false, "defaultValue": null, "validation": "Repository-relative parent milestone overview.", "valueType": "string" }, { "kind": "option", "name": "sliceOverview", "required": false, "variadic": false, "defaultValue": null, "validation": "Repository-relative lightweight parent slice overview.", "valueType": "string" }, { "kind": "option", "name": "lightweight", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Create a lightweight direct task." }, { "kind": "option", "name": "taskSlug", "required": false, "variadic": false, "defaultValue": null, "validation": "Declared ordered task slug unless fullSet is true.", "valueType": "string" }, { "kind": "option", "name": "fullSet", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Create every declared task." }, { "kind": "option", "name": "taskTitle", "required": false, "variadic": false, "defaultValue": null, "validation": "Optional explicit H1 title.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Creates task artifacts.", "argv": [ "day-shift", "task", "new", "--milestone-overview", ".day-shift/planning/example/milestone-overview.md", "--full-set" ] } ], "effects": { "filesystem": "write", "scope": "task directory with task definition and implementation summary", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "task.new:creates-artifacts", "kind": "creates-artifacts", "expected": "Applies the declared creates-artifacts transition within planning-layer scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared creates-artifacts transition is reflected by canonical repository evidence." } ] } }, { "command": "task promote", "capability": "scaffold", "primaryCapability": "scaffold", "summary": "Promotes planning work into task artifacts.", "writeCapable": true, "artifactFamily": "planning", "destinationPosture": "canonical-artifact", "targetPathPosture": "promoted task planning artifacts", "coordinationScope": "planning-layer", "mutationPosture": "creates-artifacts", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "taskDefinition", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "dryRun", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Promotes planning work into task artifacts.", "argv": [ "day-shift", "task", "promote" ] } ], "effects": { "filesystem": "write", "scope": "promoted task planning artifacts", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "task.promote:creates-artifacts", "kind": "creates-artifacts", "expected": "Applies the declared creates-artifacts transition within planning-layer scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared creates-artifacts transition is reflected by canonical repository evidence." } ] } }, { "command": "task readiness-review", "capability": "review", "primaryCapability": "review", "summary": "Reviews task readiness without writing.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "taskDefinition", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reviews task readiness without writing.", "argv": [ "day-shift", "task", "readiness-review", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "task.readiness-review:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "task review", "capability": "review", "primaryCapability": "review", "summary": "Reviews task closeout evidence without writing.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "taskDefinition", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reviews task closeout evidence without writing.", "argv": [ "day-shift", "task", "review", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "task.review:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "task update", "capability": "update", "primaryCapability": "update", "summary": "Updates task definition metadata.", "writeCapable": true, "artifactFamily": "planning", "destinationPosture": "selected-existing-artifact", "targetPathPosture": "selected task definition", "coordinationScope": "selected-artifact", "mutationPosture": "updates-selected-artifact", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "taskDefinition", "required": true, "variadic": false, "defaultValue": null, "validation": "Repository-relative task-definition.md path.", "valueType": "string" }, { "kind": "option", "name": "activeArtifact", "required": false, "variadic": false, "defaultValue": null, "validation": "Optional matching active-artifact guard.", "valueType": "string" }, { "kind": "option", "name": "field", "required": true, "variadic": true, "defaultValue": null, "validation": "One or more direct key=value metadata updates.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Updates task definition metadata.", "argv": [ "day-shift", "task", "update", "--task-definition", ".day-shift/planning/example/task-definition.md", "--field", "readiness=completed", "--field", "status=completed" ] } ], "effects": { "filesystem": "write", "scope": "selected task definition", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": true, "idempotency": "operation-defined", "preconditions": [ { "id": "selected-artifact", "description": "A current repository-relative planning artifact selection is available.", "kind": "selection", "required": true } ], "transition": { "id": "task.update:updates-selected-artifact", "kind": "updates-selected-artifact", "expected": "Applies the declared updates-selected-artifact transition within selected-artifact scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-selected-artifact transition is reflected by canonical repository evidence." } ] } }, { "command": "template", "capability": "inspection", "primaryCapability": "inspection", "summary": "Groups template materialization and update surfaces.", "writeCapable": false, "artifactFamily": "template", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups template materialization and update surfaces.", "argv": [ "day-shift", "template", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "template:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "template materialize", "capability": "materialize", "primaryCapability": "materialize", "summary": "Materializes a template to its destination.", "writeCapable": true, "artifactFamily": "template", "destinationPosture": "canonical-artifact", "targetPathPosture": "template destination path", "coordinationScope": "selected-artifact", "mutationPosture": "materializes-assets", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "template", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "mode", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "destination", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "manifestDestination", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "placeholder", "valueType": "string", "required": false, "variadic": true, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "dryRun", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "force", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Materializes a template to its destination.", "argv": [ "day-shift", "template", "materialize" ] } ], "effects": { "filesystem": "write", "scope": "template destination path", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": true, "idempotency": "operation-defined", "preconditions": [ { "id": "selected-artifact", "description": "A current repository-relative planning artifact selection is available.", "kind": "selection", "required": true } ], "transition": { "id": "template.materialize:materializes-assets", "kind": "materializes-assets", "expected": "Applies the declared materializes-assets transition within selected-artifact scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared materializes-assets transition is reflected by canonical repository evidence." } ] } }, { "command": "template update", "capability": "update", "primaryCapability": "update", "summary": "Updates template metadata.", "writeCapable": true, "artifactFamily": "template", "destinationPosture": "selected-existing-artifact", "targetPathPosture": "selected template front matter", "coordinationScope": "selected-artifact", "mutationPosture": "updates-selected-artifact", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "template", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "field", "valueType": "string", "required": false, "variadic": true, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Updates template metadata.", "argv": [ "day-shift", "template", "update" ] } ], "effects": { "filesystem": "write", "scope": "selected template front matter", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": true, "idempotency": "operation-defined", "preconditions": [ { "id": "selected-artifact", "description": "A current repository-relative planning artifact selection is available.", "kind": "selection", "required": true } ], "transition": { "id": "template.update:updates-selected-artifact", "kind": "updates-selected-artifact", "expected": "Applies the declared updates-selected-artifact transition within selected-artifact scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-selected-artifact transition is reflected by canonical repository evidence." } ] } }, { "command": "templates", "capability": "list", "primaryCapability": "list", "summary": "Lists available templates.", "writeCapable": false, "artifactFamily": "template", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Lists available templates.", "argv": [ "day-shift", "templates", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "templates:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "templates list", "capability": "list", "primaryCapability": "list", "summary": "Lists available template inventory.", "writeCapable": false, "artifactFamily": "template", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Lists available template inventory.", "argv": [ "day-shift", "templates", "list", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "templates.list:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "validation", "capability": "validation", "primaryCapability": "validation", "summary": "Groups validation report and checkpoint surfaces.", "writeCapable": false, "artifactFamily": "validation", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups validation report and checkpoint surfaces.", "argv": [ "day-shift", "validation", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "validation:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "validation checkpoint", "capability": "sync", "primaryCapability": "sync", "summary": "Writes a forward-only validation baseline.", "writeCapable": true, "artifactFamily": "validation", "destinationPosture": "derived-state", "targetPathPosture": ".day-shift/state validation baseline", "coordinationScope": "workspace", "mutationPosture": "updates-derived-state", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "scope", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Writes a forward-only validation baseline.", "argv": [ "day-shift", "validation", "checkpoint" ] } ], "effects": { "filesystem": "write", "scope": ".day-shift/state validation baseline", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "validation.checkpoint:updates-derived-state", "kind": "updates-derived-state", "expected": "Applies the declared updates-derived-state transition within workspace scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-derived-state transition is reflected by canonical repository evidence." } ] } }, { "command": "validation diff-check", "capability": "validation", "primaryCapability": "validation", "summary": "Reserved diff-check validation report surface.", "writeCapable": false, "artifactFamily": "validation", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reserved diff-check validation report surface.", "argv": [ "day-shift", "validation", "diff-check", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "validation.diff-check:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "validation impact-analysis", "capability": "validation", "primaryCapability": "validation", "summary": "Reserved impact-analysis validation report surface.", "writeCapable": false, "artifactFamily": "validation", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reserved impact-analysis validation report surface.", "argv": [ "day-shift", "validation", "impact-analysis", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "validation.impact-analysis:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "validation links-check", "capability": "validation", "primaryCapability": "validation", "summary": "Reports local trace-link evidence.", "writeCapable": false, "artifactFamily": "validation", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "scope", "required": false, "variadic": false, "defaultValue": "planning", "validation": "Currently planning.", "valueType": "string" }, { "kind": "option", "name": "format", "required": false, "variadic": false, "defaultValue": "text", "validation": "text or json.", "valueType": "string" }, { "kind": "option", "name": "artifact", "required": false, "variadic": false, "defaultValue": null, "validation": "Optional repository-relative planning artifact or directory.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reports local trace-link evidence.", "argv": [ "day-shift", "validation", "links-check", "--scope", "planning", "--artifact", ".day-shift/planning/example/phase-overview.md", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "validation.links-check:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "validation rollup", "capability": "validation", "primaryCapability": "validation", "summary": "Reports validation rollup evidence.", "writeCapable": false, "artifactFamily": "validation", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "scope", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "format", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "artifact", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reports validation rollup evidence.", "argv": [ "day-shift", "validation", "rollup", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "validation.rollup:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "validation scope-guard", "capability": "validation", "primaryCapability": "validation", "summary": "Reserved scope-guard validation report surface.", "writeCapable": false, "artifactFamily": "validation", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reserved scope-guard validation report surface.", "argv": [ "day-shift", "validation", "scope-guard", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "validation.scope-guard:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "validation smoke", "capability": "validation", "primaryCapability": "validation", "summary": "Reports planning validation smoke findings.", "writeCapable": false, "artifactFamily": "validation", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "scope", "required": false, "variadic": false, "defaultValue": "planning", "validation": "Currently planning.", "valueType": "string" }, { "kind": "option", "name": "artifact", "required": false, "variadic": false, "defaultValue": null, "validation": "Optional repository-relative selected planning artifact.", "valueType": "string" }, { "kind": "option", "name": "action", "required": false, "variadic": false, "defaultValue": null, "validation": "Exact authoritative command descriptor id; requires artifact.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reports planning validation smoke findings.", "argv": [ "day-shift", "validation", "smoke", "--scope", "planning", "--artifact", ".day-shift/planning/example/phase-overview.md", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "validation.smoke:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "version", "capability": "inspection", "primaryCapability": "inspection", "summary": "Groups installed Day Shift version manager surfaces.", "writeCapable": false, "artifactFamily": "release", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups installed Day Shift version manager surfaces.", "argv": [ "day-shift", "version", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "version:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "version alias", "capability": "update", "primaryCapability": "update", "summary": "Groups version-manager alias update surfaces.", "writeCapable": true, "artifactFamily": "release", "destinationPosture": "derived-state", "targetPathPosture": "version-manager alias metadata", "coordinationScope": "local-installation", "mutationPosture": "updates-derived-state", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups version-manager alias update surfaces.", "argv": [ "day-shift", "version", "alias" ] } ], "effects": { "filesystem": "write", "scope": "version-manager alias metadata", "network": "none", "hostState": "write", "destructive": false, "interactive": false }, "authorization": "host-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "version.alias:updates-derived-state", "kind": "updates-derived-state", "expected": "Applies the declared updates-derived-state transition within local-installation scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-derived-state transition is reflected by canonical repository evidence." } ] } }, { "command": "version alias list", "capability": "list", "primaryCapability": "list", "summary": "Lists version-manager aliases.", "writeCapable": false, "artifactFamily": "release", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Lists version-manager aliases.", "argv": [ "day-shift", "version", "alias", "list", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "version.alias.list:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "version alias set", "capability": "update", "primaryCapability": "update", "summary": "Sets a version-manager alias.", "writeCapable": true, "artifactFamily": "release", "destinationPosture": "derived-state", "targetPathPosture": "version-manager alias metadata", "coordinationScope": "local-installation", "mutationPosture": "updates-derived-state", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "argument", "name": "name", "valueType": "string", "required": true, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "argument", "name": "version", "valueType": "string", "required": true, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Sets a version-manager alias.", "argv": [ "day-shift", "version", "alias", "set" ] } ], "effects": { "filesystem": "write", "scope": "version-manager alias metadata", "network": "none", "hostState": "write", "destructive": false, "interactive": false }, "authorization": "host-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "version.alias.set:updates-derived-state", "kind": "updates-derived-state", "expected": "Applies the declared updates-derived-state transition within local-installation scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-derived-state transition is reflected by canonical repository evidence." } ] } }, { "command": "version check", "capability": "validation", "primaryCapability": "validation", "summary": "Checks version availability without installing.", "writeCapable": false, "artifactFamily": "release", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "argument", "name": "version", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "network", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Checks version availability without installing.", "argv": [ "day-shift", "version", "check", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "version.check:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "version current", "capability": "inspection", "primaryCapability": "inspection", "summary": "Reports the currently selected managed version.", "writeCapable": false, "artifactFamily": "release", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reports the currently selected managed version.", "argv": [ "day-shift", "version", "current", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "version.current:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "version doctor", "capability": "inspection", "primaryCapability": "inspection", "summary": "Reports version-manager diagnostics.", "writeCapable": false, "artifactFamily": "release", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reports version-manager diagnostics.", "argv": [ "day-shift", "version", "doctor", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "version.doctor:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "version install", "capability": "install", "primaryCapability": "install", "summary": "Installs a local Day Shift package source into version-manager state.", "writeCapable": true, "artifactFamily": "release", "destinationPosture": "local-install-target", "targetPathPosture": "version-manager package state", "coordinationScope": "local-installation", "mutationPosture": "installs-local-files", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "from", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "assertVersion", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Installs a local Day Shift package source into version-manager state.", "argv": [ "day-shift", "version", "install" ] } ], "effects": { "filesystem": "write", "scope": "version-manager package state", "network": "none", "hostState": "write", "destructive": false, "interactive": false }, "authorization": "host-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "version.install:installs-local-files", "kind": "installs-local-files", "expected": "Applies the declared installs-local-files transition within local-installation scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared installs-local-files transition is reflected by canonical repository evidence." } ] } }, { "command": "version list", "capability": "list", "primaryCapability": "list", "summary": "Lists installed managed versions.", "writeCapable": false, "artifactFamily": "release", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Lists installed managed versions.", "argv": [ "day-shift", "version", "list", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "version.list:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "version pin", "capability": "update", "primaryCapability": "update", "summary": "Pins managed version selection.", "writeCapable": true, "artifactFamily": "release", "destinationPosture": "derived-state", "targetPathPosture": "version-manager selection metadata", "coordinationScope": "local-installation", "mutationPosture": "updates-derived-state", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "argument", "name": "version", "valueType": "string", "required": true, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Pins managed version selection.", "argv": [ "day-shift", "version", "pin" ] } ], "effects": { "filesystem": "write", "scope": "version-manager selection metadata", "network": "none", "hostState": "write", "destructive": false, "interactive": false }, "authorization": "host-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "version.pin:updates-derived-state", "kind": "updates-derived-state", "expected": "Applies the declared updates-derived-state transition within local-installation scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-derived-state transition is reflected by canonical repository evidence." } ] } }, { "command": "version uninstall", "capability": "cleanup", "primaryCapability": "cleanup", "summary": "Uninstalls managed versions from local state.", "writeCapable": true, "artifactFamily": "release", "destinationPosture": "local-install-target", "targetPathPosture": "version-manager package state", "coordinationScope": "local-installation", "mutationPosture": "prunes-generated-output", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "argument", "name": "version", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "replaceWith", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "confirmSelectedRemoval", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Uninstalls managed versions from local state.", "argv": [ "day-shift", "version", "uninstall" ] } ], "effects": { "filesystem": "write", "scope": "version-manager package state", "network": "none", "hostState": "write", "destructive": false, "interactive": false }, "authorization": "host-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "version.uninstall:prunes-generated-output", "kind": "prunes-generated-output", "expected": "Applies the declared prunes-generated-output transition within local-installation scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared prunes-generated-output transition is reflected by canonical repository evidence." } ] } }, { "command": "version use", "capability": "update", "primaryCapability": "update", "summary": "Selects a managed version for current use.", "writeCapable": true, "artifactFamily": "release", "destinationPosture": "derived-state", "targetPathPosture": "version-manager selection metadata", "coordinationScope": "local-installation", "mutationPosture": "updates-derived-state", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "argument", "name": "version", "valueType": "string", "required": true, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Selects a managed version for current use.", "argv": [ "day-shift", "version", "use" ] } ], "effects": { "filesystem": "write", "scope": "version-manager selection metadata", "network": "none", "hostState": "write", "destructive": false, "interactive": false }, "authorization": "host-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "version.use:updates-derived-state", "kind": "updates-derived-state", "expected": "Applies the declared updates-derived-state transition within local-installation scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-derived-state transition is reflected by canonical repository evidence." } ] } }, { "command": "work", "capability": "navigation", "primaryCapability": "navigation", "summary": "Groups explicit planning-work candidate and selection surfaces.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups explicit planning-work candidate and selection surfaces.", "argv": [ "day-shift", "work", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "work:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "work candidates", "capability": "navigation", "primaryCapability": "navigation", "summary": "Reports bounded advisory planning-work candidates without writing selection state.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "root", "required": false, "variadic": false, "defaultValue": ".day-shift/planning", "validation": "Repository-relative planning root or subdirectory.", "valueType": "string" }, { "kind": "option", "name": "maxResults", "required": false, "variadic": false, "defaultValue": 10, "validation": "Integer from 1 to 50.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Reports bounded advisory planning-work candidates without writing selection state.", "argv": [ "day-shift", "work", "candidates", "--root", ".day-shift/planning", "--max-results", "10", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "work.candidates:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "work cleanup", "capability": "cleanup", "primaryCapability": "cleanup", "summary": "Clears stale named selection state while preserving fresh or absent state.", "writeCapable": true, "artifactFamily": "planning", "destinationPosture": "derived-state", "targetPathPosture": "user-local work selection state", "coordinationScope": "workspace", "mutationPosture": "updates-derived-state", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "session", "required": false, "variadic": false, "defaultValue": "default", "validation": "Validated local session name.", "valueType": "string" }, { "kind": "option", "name": "ifMatch", "required": false, "variadic": false, "defaultValue": null, "validation": "Opaque token from work current; required to clear stale state.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Clears stale named selection state while preserving fresh or absent state.", "argv": [ "day-shift", "work", "cleanup", "--session", "default", "--if-match", "" ] } ], "effects": { "filesystem": "write", "scope": "user-local work selection state", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "host-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "work.cleanup:updates-derived-state", "kind": "updates-derived-state", "expected": "Applies the declared updates-derived-state transition within workspace scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-derived-state transition is reflected by canonical repository evidence." } ] } }, { "command": "work clear", "capability": "cleanup", "primaryCapability": "cleanup", "summary": "Clears one named user-local work selection session.", "writeCapable": true, "artifactFamily": "planning", "destinationPosture": "derived-state", "targetPathPosture": "user-local work selection state", "coordinationScope": "workspace", "mutationPosture": "updates-derived-state", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "session", "required": false, "variadic": false, "defaultValue": "default", "validation": "Validated local session name.", "valueType": "string" }, { "kind": "option", "name": "ifMatch", "required": false, "variadic": false, "defaultValue": null, "validation": "Opaque token from work current; required when session state exists.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Clears one named user-local work selection session.", "argv": [ "day-shift", "work", "clear", "--session", "default" ] } ], "effects": { "filesystem": "write", "scope": "user-local work selection state", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "host-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "work.clear:updates-derived-state", "kind": "updates-derived-state", "expected": "Applies the declared updates-derived-state transition within workspace scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-derived-state transition is reflected by canonical repository evidence." } ] } }, { "command": "work current", "capability": "inspection", "primaryCapability": "inspection", "summary": "Inspects one named user-local work selection and freshness.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "session", "required": false, "variadic": false, "defaultValue": "default", "validation": "Validated local session name.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Inspects one named user-local work selection and freshness.", "argv": [ "day-shift", "work", "current", "--session", "default", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "work.current:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "work next", "capability": "navigation", "primaryCapability": "navigation", "summary": "Resolves explicit or stored selection and reports its next action.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "artifact", "required": false, "variadic": false, "defaultValue": null, "validation": "Optional existing repository-relative planning artifact.", "valueType": "string" }, { "kind": "option", "name": "session", "required": false, "variadic": false, "defaultValue": "default", "validation": "Validated local session name.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Resolves explicit or stored selection and reports its next action.", "argv": [ "day-shift", "work", "next", "--artifact", ".day-shift/planning/example/task-definition.md", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "work.next:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "work select", "capability": "update", "primaryCapability": "update", "summary": "Selects one planning artifact in a named user-local session.", "writeCapable": true, "artifactFamily": "planning", "destinationPosture": "derived-state", "targetPathPosture": "user-local work selection state", "coordinationScope": "workspace", "mutationPosture": "updates-derived-state", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "artifact", "required": true, "variadic": false, "defaultValue": null, "validation": "Existing repository-relative planning artifact.", "valueType": "string" }, { "kind": "option", "name": "session", "required": false, "variadic": false, "defaultValue": "default", "validation": "Validated local session name.", "valueType": "string" }, { "kind": "option", "name": "intent", "required": false, "variadic": false, "defaultValue": null, "validation": "Optional printable provenance up to 256 characters.", "valueType": "string" }, { "kind": "option", "name": "ifMatch", "required": false, "variadic": false, "defaultValue": null, "validation": "Opaque token from work current; required to replace existing session state.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Selects one planning artifact in a named user-local session.", "argv": [ "day-shift", "work", "select", "--artifact", ".day-shift/planning/example/task-definition.md" ] } ], "effects": { "filesystem": "write", "scope": "user-local work selection state", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "host-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "work.select:updates-derived-state", "kind": "updates-derived-state", "expected": "Applies the declared updates-derived-state transition within workspace scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared updates-derived-state transition is reflected by canonical repository evidence." } ] } }, { "command": "workflow", "capability": "navigation", "primaryCapability": "navigation", "summary": "Groups workflow explanation surfaces.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups workflow explanation surfaces.", "argv": [ "day-shift", "workflow", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "workflow:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "workflow explain", "capability": "navigation", "primaryCapability": "navigation", "summary": "Explains the workflow and prompt for a selected artifact.", "writeCapable": false, "artifactFamily": "planning", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [ { "kind": "option", "name": "artifact", "required": true, "variadic": false, "defaultValue": null, "validation": "Repository-relative selected planning artifact.", "valueType": "string" } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Explains the workflow and prompt for a selected artifact.", "argv": [ "day-shift", "workflow", "explain", "--artifact", ".day-shift/planning/example/phase-overview.md", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "workflow.explain:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "workspace", "capability": "inspection", "primaryCapability": "inspection", "summary": "Groups workspace inspection and migration surfaces.", "writeCapable": false, "artifactFamily": "workspace", "destinationPosture": "none", "targetPathPosture": "none", "coordinationScope": "none", "mutationPosture": "non-writing", "noWriteBoundary": "Reports local command evidence only and writes no files.", "aliases": [], "inputs": [], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Groups workspace inspection and migration surfaces.", "argv": [ "day-shift", "workspace", "--format", "json" ] } ], "effects": { "filesystem": "read", "scope": "repository-local evidence", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "read", "confirmation": "none", "selectionRequired": false, "idempotency": "idempotent", "preconditions": [], "transition": { "id": "workspace:state-observed", "kind": "state-observed", "expected": "Returns current evidence without changing repository or host state.", "expectedPostconditions": [ { "id": "state-reported-without-write", "description": "Current evidence is returned and repository and host state remain unchanged." } ] } }, { "command": "workspace migrate", "capability": "migration", "primaryCapability": "migration", "summary": "Plans or applies explicit workspace metadata migrations.", "writeCapable": true, "artifactFamily": "workspace", "destinationPosture": "workspace-metadata", "targetPathPosture": ".day-shift workspace metadata", "coordinationScope": "workspace", "mutationPosture": "applies-migration", "noWriteBoundary": "Write-capable command; mutation is limited to the declared artifact family, destination posture, target-path posture, and coordination scope.", "aliases": [], "inputs": [ { "kind": "option", "name": "targetSchemaVersion", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "dryRun", "valueType": "boolean", "required": false, "variadic": false, "defaultValue": false, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "confirm", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "family", "valueType": "string", "required": false, "variadic": false, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." }, { "kind": "option", "name": "field", "valueType": "string", "required": false, "variadic": true, "defaultValue": null, "validation": "Validated by the command adapter; descriptor/runtime input-name drift is enforced globally." } ], "validationNotes": [ "Arguments and options are validated by the command adapter; descriptor/runtime drift is checked separately." ], "examples": [ { "description": "Plans or applies explicit workspace metadata migrations.", "argv": [ "day-shift", "workspace", "migrate" ] } ], "effects": { "filesystem": "write", "scope": ".day-shift workspace metadata", "network": "none", "hostState": "none", "destructive": false, "interactive": false }, "authorization": "workspace-write", "confirmation": "explicit-command", "selectionRequired": false, "idempotency": "operation-defined", "preconditions": [], "transition": { "id": "workspace.migrate:applies-migration", "kind": "applies-migration", "expected": "Applies the declared applies-migration transition within workspace scope.", "expectedPostconditions": [ { "id": "declared-transition-applied", "description": "The declared applies-migration transition is reflected by canonical repository evidence." } ] } } ] }