cclaw-cli 0.1.0 → 0.1.1

package/README.md

@@ -77,6 +77,34 @@ npx cclaw-cli upgrade
 npx cclaw-cli uninstall
 ```
 
+## PR-First Ship Flow
+
+`cclaw` does not run hidden git automation. It enforces release discipline inside the harness and keeps repository actions explicit.
+
+Recommended shipping path:
+
+```bash
+git checkout main
+git pull origin main
+git checkout -b feat/<topic>
+# implement with cclaw stages in the harness
+git add .
+git commit -m "..."
+git push -u origin HEAD
+gh pr create
+```
+
+After merge to `main`, CI handles release lifecycle:
+
+- `Release Drafter` updates draft notes from merged PRs.
+- `Release Publish` validates the build, publishes to npm (if version is new), publishes an existing release draft or creates a new GitHub Release, and uploads `.tgz` + plugin manifest artifacts.
+- `Release Package` remains available for manual release/event-driven packaging flows.
+- To trigger a new publish, bump `package.json` version in the PR before merge.
+
+Required repository secret:
+
+- `NPM_TOKEN` with publish access to the npm package.
+
 ## What Gets Generated
 
 ```text

package/dist/cli.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { realpathSync } from "node:fs";
 import process from "node:process";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -93,9 +94,19 @@ async function main() {
         process.exitCode = 1;
     }
 }
-const entryPath = process.argv[1] ? path.resolve(process.argv[1]) : "";
-const modulePath = fileURLToPath(import.meta.url);
-if (entryPath === modulePath) {
+function isDirectExecution() {
+    if (!process.argv[1])
+        return false;
+    try {
+        const entryPath = realpathSync(path.resolve(process.argv[1]));
+        const modulePath = realpathSync(fileURLToPath(import.meta.url));
+        return entryPath === modulePath;
+    }
+    catch {
+        return false;
+    }
+}
+if (isDirectExecution()) {
     void main();
 }
 export { parseArgs, parseHarnesses };

package/dist/config.js

@@ -10,7 +10,8 @@ const SUPPORTED_HARNESSES_TEXT = HARNESS_IDS.join(", ");
 function configFixExample() {
     return `harnesses:
   - claude
-  - cursor`;
+  - cursor
+`;
 }
 function configValidationError(configFilePath, reason) {
     return new Error(`Invalid cclaw config at ${configFilePath}: ${reason}\n` +

package/dist/doctor.js

@@ -223,19 +223,13 @@ export async function doctorChecks(projectRoot) {
         const hasAllCommands = COMMAND_FILE_ORDER.every((stage) => content.includes(`/cc-${stage}`));
         const hasRouting = content.includes("Intent → Stage Routing") || content.includes("Intent → Stage");
         const hasVerification = content.includes("Verification Discipline");
-        const hasFileMap = content.includes("File Map");
-        const hasLearnings = content.includes("Learnings Store");
-        const hasAutoplan = content.includes("Autoplan Orchestrator");
-        const hasAgents = content.includes("Agent Specialists");
-        const hasSubagents = content.includes("Subagent Orchestration");
-        const hasSessionProtocols = content.includes("Session Guidelines");
-        const hasHooks = content.includes("Hooks");
-        agentsBlockOk = hasMarkers && hasAllCommands && hasRouting && hasVerification && hasFileMap && hasLearnings && hasAutoplan && hasAgents && hasSubagents && hasSessionProtocols && hasHooks;
+        const hasDetailLevel = content.includes("Detail Level");
+        agentsBlockOk = hasMarkers && hasAllCommands && hasRouting && hasVerification && hasDetailLevel;
     }
     checks.push({
         name: "agents:cclaw_block",
         ok: agentsBlockOk,
-        details: `${agentsFile} must contain cclaw marker block with routing, verification, and file map`
+        details: `${agentsFile} must contain cclaw marker block with compact routing and verification guidance`
     });
     // Utility commands
     for (const cmd of ["learn", "autoplan"]) {

package/dist/harness-adapters.js

@@ -1,12 +1,7 @@
 import fs from "node:fs/promises";
 import path from "node:path";
 import { COMMAND_FILE_ORDER, RUNTIME_ROOT } from "./constants.js";
-import { CCLAW_AGENTS, agentMarkdown, agentsAgentsMdBlock } from "./content/agents.js";
-import { autoplanAgentsMdBlock } from "./content/autoplan.js";
-import { learningsAgentsMdBlock } from "./content/learnings.js";
-import { sessionHooksAgentsMdBlock } from "./content/session-hooks.js";
-import { hooksAgentsMdBlock } from "./content/hooks.js";
-import { subagentsAgentsMdBlock } from "./content/subagents.js";
+import { CCLAW_AGENTS, agentMarkdown } from "./content/agents.js";
 import { stageSkillFolder } from "./content/skills.js";
 import { ensureDir, exists, writeFileSafe } from "./fs-utils.js";
 export const CCLAW_MARKER_START = "<!-- cclaw-start -->";
@@ -48,9 +43,10 @@ Do not skip required handoff gates.
 function agentsMdBlock() {
     const stageList = COMMAND_FILE_ORDER.map((s) => `| \`/cc-${s}\` | \`.cclaw/skills/${stageSkillFolder(s)}/SKILL.md\` + \`.cclaw/commands/${s}.md\` |`).join("\n");
     return `${CCLAW_MARKER_START}
-## Cclaw — Structured Development Flow
+## Cclaw — Workflow Adapter
 
-> Auto-generated by \`cclaw sync\`. Do not edit manually — run \`npx cclaw sync\`.
+> Auto-generated by \`cclaw sync\`. Do not edit this managed block manually.
+> Existing project rules in this repository take precedence over cclaw defaults.
 
 ### Activation Rule
 
@@ -68,30 +64,16 @@ ${stageList}
 | \`/cc-autoplan\` | \`.cclaw/skills/autoplan/SKILL.md\` + \`.cclaw/commands/autoplan.md\` |
 
 **Stage order:** brainstorm > scope > design > spec > plan > test > build > review > ship.
-One stage per invocation. Gates must pass before handoff. Artifacts in \`.cclaw/artifacts/\`.
+One stage per invocation. Gates must pass before handoff.
 
 ### Verification Discipline
 
 No completion claims without fresh evidence. No "Done" / "All good" / "Tests pass" without running the command in this message.
 
-### File Map
+### Detail Level
 
-| Path | Purpose |
-|---|---|
-| \`.cclaw/commands/*.md\` | Stage commands (thin orchestrators) |
-| \`.cclaw/skills/*/SKILL.md\` | Full stage instructions |
-| \`.cclaw/rules/\` | RULES.md + rules.json |
-| \`.cclaw/state/flow-state.json\` | Flow state & gate tracking |
-| \`.cclaw/artifacts/*.md\` | Stage evidence artifacts |
-| \`.cclaw/agents/*.md\` | Specialist agent personas |
-| \`.cclaw/learnings.jsonl\` | Project knowledge base |
-
-${learningsAgentsMdBlock()}
-${autoplanAgentsMdBlock()}
-${agentsAgentsMdBlock()}
-${subagentsAgentsMdBlock()}
-${sessionHooksAgentsMdBlock()}
-${hooksAgentsMdBlock()}
+- This managed AGENTS block is intentionally minimal for cross-project use.
+- Detailed operating procedures live in \`.cclaw/skills/using-cclaw/SKILL.md\`.
 ${CCLAW_MARKER_END}`;
 }
 /** Removes the cclaw AGENTS.md block. */

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "cclaw-cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Installer-first flow toolkit for coding agents",
   "type": "module",
   "bin": {
+    "cclaw-cli": "dist/cli.js",
     "cclaw": "dist/cli.js"
   },
   "files": [