cclaw-cli 0.1.0 → 0.2.0

package/dist/content/autoplan.js

@@ -68,10 +68,17 @@ This skill describes **what the agent must do when invoked as \`/cc-autoplan\`**
 ### Phase 2 — Scope (always runs)
 
 - Follow \`.cclaw/skills/scope-shaping/SKILL.md\` at **full depth**.
-- **Default mode selection:**
-  - **SELECTIVE_EXPANSION** for **greenfield** work (new capability, new subsystem, new user-facing flow with meaningful net-new behavior).
-  - **HOLD** for **enhancement/bugfix** work (tight blast radius, correctness/perf/regression risk dominates).
+- **Run scope-mode heuristics** (see dedicated section below), then select exactly one:
+  - **SCOPE_EXPANSION** (dream big)
+  - **SELECTIVE_EXPANSION** (hold core scope, cherry-pick high-value expansions)
+  - **HOLD** (maximum rigor on requested scope)
+  - **SCOPE_REDUCTION** (strip to essentials)
+- **Default recommendation (before scoring):**
+  - Greenfield/product-bet starts at **SELECTIVE_EXPANSION**.
+  - Enhancement/bugfix starts at **HOLD**.
+  - If predicted blast radius is **>15 files** or introduces new infra under tight constraints, bias toward **SCOPE_REDUCTION**.
 - **Auto-answer** scope boundary questions when they are **mechanical** or **taste** (never user challenges).
+- **Surface requirement:** write a **Scope Mode Heuristics** table and final selected mode rationale in \`02-scope.md\`.
 - **Artifact:** \`.cclaw/artifacts/02-scope.md\`
 
 ### Phase 3 — Design (always runs)
@@ -151,6 +158,34 @@ Present a **structured summary** to the user and **do not proceed** to implement
   - cost if the agent is wrong
 - **Gate:** Wait for explicit user resolution before treating that thread as decided.
 
+## Scope Mode Heuristics (Phase 2)
+
+Score each signal as **+1** (expansion bias), **0** (neutral), or **-1** (contraction bias), then total.
+Record the scoring table in \`.cclaw/artifacts/02-scope.md\`.
+
+| Signal | +1 Expansion Bias | 0 Neutral | -1 Contraction Bias |
+|---|---|---|---|
+| Product novelty | Net-new workflow/subsystem | Moderate feature extension | Bugfix or narrow patch |
+| User value upside | Material step-function in UX/DX/business value | Incremental improvement | Marginal gain only |
+| Blast radius | Limited, coherent module set | Mixed | Wide cross-cutting changes |
+| Delivery risk | Low dependency and integration risk | Moderate | High regression or unknown coupling |
+| Time/constraint pressure | Flexible timeline | Manageable | Tight deadline or strict compliance window |
+| Operability burden | Existing observability/release path supports growth | Partial readiness | Missing guardrails; expansion would outpace controls |
+
+**Mode recommendation by score:**
+- **+3 or higher:** recommend **SCOPE_EXPANSION**
+- **+1 to +2:** recommend **SELECTIVE_EXPANSION**
+- **0 to -2:** recommend **HOLD**
+- **-3 or lower:** recommend **SCOPE_REDUCTION**
+
+**Override heuristics (higher priority):**
+- If user asks for immediate bugfix/hotfix with reliability urgency, floor mode at **HOLD**.
+- If expansion requires new infra/service boundaries without prior operational readiness, prefer **SCOPE_REDUCTION** or **HOLD**.
+- If user explicitly requests an ambitious bet and constraints are flexible, allow **SCOPE_EXPANSION** even when score is borderline (must log risk assumptions).
+
+**Surfacing rule:**
+- Final Approval Gate must include: selected mode, score summary, and top 2 signals that drove the choice.
+
 ## Decision Audit Trail (running table)
 
 After **each** auto-decision (mechanical or taste), append a row to the running table stored in \`.cclaw/artifacts/05-plan.md\` (create the table if missing):
@@ -235,7 +270,7 @@ Run **brainstorm → scope → design → spec → plan** as a single orchestrat
 
 1. **Phase 0 — Intake:** restore point + context scan + UI/DX scope flags + read all five stage skills.
 2. **Phase 1 — Brainstorm:** full \`brainstorming\` skill depth → \`.cclaw/artifacts/01-brainstorm.md\`.
-3. **Phase 2 — Scope:** full \`scope-shaping\` skill depth (greenfield default **SELECTIVE_EXPANSION**, enhancement/bug default **HOLD**) → \`02-scope.md\`.
+3. **Phase 2 — Scope:** full \`scope-shaping\` skill depth + scope-mode heuristic scoring (EXPANSION / SELECTIVE / HOLD / REDUCTION) → \`02-scope.md\`.
 4. **Phase 3 — Design:** full \`engineering-design-lock\` skill depth; all review sections evaluated → \`03-design.md\`.
 5. **Phase 4 — Spec:** full \`specification-authoring\` skill depth → \`04-spec.md\`.
 6. **Phase 5 — Plan:** full \`planning-and-task-breakdown\` skill depth; maintain audit trail table → \`05-plan.md\`.
@@ -258,6 +293,17 @@ Run **brainstorm → scope → design → spec → plan** as a single orchestrat
 - **Taste:** reasonable disagreement → auto-decide with recommendation + **audit log row** + **surface at gate** with **one-line rejected-alternative impact**.
 - **User Challenge:** agent recommends changing user direction → **never** auto-decide; present evidence + costs; await user.
 
+## Scope Mode Heuristics (Phase 2)
+
+- Score six scope signals (+1 / 0 / -1): novelty, value upside, blast radius, delivery risk, time pressure, operability burden.
+- Map total score to recommendation:
+  - **+3+** → **SCOPE_EXPANSION**
+  - **+1..+2** → **SELECTIVE_EXPANSION**
+  - **0..-2** → **HOLD**
+  - **-3-** → **SCOPE_REDUCTION**
+- Apply overrides: urgent bugfixes floor at **HOLD**; high-risk infra expansion biases **HOLD/REDUCTION**.
+- Persist scoring + selected mode in \`02-scope.md\`, then surface it again in the Final Approval Gate summary.
+
 ## Final Approval Gate (options A-E)
 
 - **(A) Approve as-is**
@@ -288,6 +334,7 @@ export function autoplanAgentsMdBlock() {
 
 Use \`/cc-autoplan\` to run brainstorm→scope→design→spec→plan in one shot with auto-decisions.
 - Mechanical questions are auto-answered using 6 principles
+- Scope mode (EXPANSION / SELECTIVE / HOLD / REDUCTION) is selected via explicit heuristic scoring in Phase 2
 - Taste decisions are auto-answered but surfaced at a single final approval gate
 - User challenges are NEVER auto-answered
 - Restore point is created before any work begins

package/dist/content/contexts.d.ts

@@ -0,0 +1,9 @@
+export declare const DEFAULT_CONTEXT_MODE = "default";
+export declare const CONTEXT_MODES: Record<string, string>;
+export declare function contextModeFiles(): Record<string, string>;
+export interface ContextModeState {
+    activeMode: string;
+    updatedAt: string;
+    availableModes: string[];
+}
+export declare function createInitialContextModeState(nowIso?: string): ContextModeState;

package/dist/content/contexts.js

@@ -0,0 +1,65 @@
+export const DEFAULT_CONTEXT_MODE = "default";
+export const CONTEXT_MODES = {
+    default: `# Context Mode: default
+
+Use for most day-to-day feature work.
+
+## Focus
+- Follow the active cclaw stage strictly.
+- Keep changes within the current task blast radius.
+- Prefer incremental progress with frequent verification.
+
+## Decision posture
+- Escalate only meaningful trade-offs.
+- Ask for user confirmation only at explicit stage gates.
+`,
+    execution: `# Context Mode: execution
+
+Use when plan/spec are approved and the goal is high-throughput delivery.
+
+## Focus
+- Prioritize deterministic implementation flow (RED -> GREEN -> REFACTOR).
+- Minimize conversational overhead; keep updates concise and evidence-first.
+- Batch machine-only checks through subagent dispatch where supported.
+
+## Decision posture
+- Avoid reopening settled design debates unless a blocker appears.
+- Stop immediately on failing quality gates or unresolved critical findings.
+`,
+    review: `# Context Mode: review
+
+Use for deep validation, risk discovery, and merge readiness.
+
+## Focus
+- Bias toward finding concrete defects, regressions, and evidence gaps.
+- Cross-check spec, plan, tests, and implementation alignment.
+- Treat unsupported claims as unverified until backed by command output.
+
+## Decision posture
+- Classify findings by severity and expected blast radius.
+- Block ship decisions when critical issues remain unresolved.
+`,
+    incident: `# Context Mode: incident
+
+Use for production failures, emergency regressions, or urgent stabilization.
+
+## Focus
+- Reproduce first, then isolate, then fix.
+- Favor smallest safe change with rollback clarity.
+- Preserve timeline and evidence for post-incident learning.
+
+## Decision posture
+- Prefer containment over optimization.
+- Require explicit evidence for declaring recovery complete.
+`
+};
+export function contextModeFiles() {
+    return { ...CONTEXT_MODES };
+}
+export function createInitialContextModeState(nowIso = new Date().toISOString()) {
+    return {
+        activeMode: DEFAULT_CONTEXT_MODE,
+        updatedAt: nowIso,
+        availableModes: Object.keys(CONTEXT_MODES)
+    };
+}

package/dist/content/hooks.d.ts

@@ -5,12 +5,16 @@
  * Stop: writes checkpoint.json and reminds about flow consistency.
  * PreToolUse/PostToolUse and summarize chain are generated in observe.ts.
  */
+export interface HookRuntimeOptions {
+    globalLearningsEnabled?: boolean;
+    globalLearningsPath?: string;
+}
 /** Shared bash preamble for generated hook scripts. */
 export declare const RUNTIME_SHELL_DETECT_ROOT = "HARNESS=\"codex\"\nif [ -n \"${CLAUDE_PROJECT_DIR:-}\" ]; then\n  HARNESS=\"claude\"\nelif [ -n \"${CURSOR_PROJECT_DIR:-}\" ] || [ -n \"${CURSOR_PROJECT_ROOT:-}\" ]; then\n  HARNESS=\"cursor\"\nelif [ -n \"${OPENCODE_PROJECT_DIR:-}\" ] || [ -n \"${OPENCODE_PROJECT_ROOT:-}\" ]; then\n  HARNESS=\"opencode\"\nfi\n\nROOT=\"\"\nfor candidate in \"${CCLAW_PROJECT_ROOT:-}\" \"${CLAUDE_PROJECT_DIR:-}\" \"${CURSOR_PROJECT_DIR:-}\" \"${CURSOR_PROJECT_ROOT:-}\" \"${OPENCODE_PROJECT_DIR:-}\" \"${OPENCODE_PROJECT_ROOT:-}\" \"${PWD:-}\"; do\n  if [ -n \"$candidate\" ] && [ -d \"$candidate/.cclaw\" ]; then\n    ROOT=\"$candidate\"\n    break\n  fi\ndone\nif [ -z \"$ROOT\" ]; then\n  ROOT=\"${CCLAW_PROJECT_ROOT:-${CLAUDE_PROJECT_DIR:-${CURSOR_PROJECT_DIR:-${CURSOR_PROJECT_ROOT:-${OPENCODE_PROJECT_DIR:-${OPENCODE_PROJECT_ROOT:-${PWD}}}}}}}\"\nfi";
-export declare function sessionStartScript(): string;
+export declare function sessionStartScript(options?: HookRuntimeOptions): string;
 export declare function stopCheckpointScript(): string;
 export { claudeHooksJsonWithObservation as claudeHooksJson } from "./observe.js";
 export { cursorHooksJsonWithObservation as cursorHooksJson } from "./observe.js";
 export { codexHooksJsonWithObservation as codexHooksJson } from "./observe.js";
-export declare function opencodePluginJs(): string;
+export declare function opencodePluginJs(options?: HookRuntimeOptions): string;
 export declare function hooksAgentsMdBlock(): string;