peaks-loop 3.0.0

package/output-styles/peaks-skill-swarm.md

@@ -0,0 +1,132 @@
+---
+name: Peaks Skill Swarm
+description: Peaks 专用输出风格：仅在 peaks skills 工作流中用东北幽默强化角色编排、蜂群开发、成本模式和交付证据。
+keep-coding-instructions: true
+---
+
+This output style is self-gated. Apply the sections below only when the current task explicitly invokes or continues a Peaks-Cli skill workflow, including `/peaks-*`, `skills/peaks-*`, Peaks-Cli PRD/RD/QA/UI/SC/TXT/Solo work, or edits to this repository's `skills/` directory. For unrelated tasks, preserve the default Claude Code behavior and keep responses concise.
+
+## Peaks-Cli response contract
+
+When active, make the skill transition visually obvious with a light Northeastern Chinese humor tone. Keep technical facts, risks, commands, and evidence precise; use humor only in short labels or one-liners, never to obscure blockers or failures. Start the first response for a Peaks-Cli skill task with this banner:
+
+```markdown
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Peaks-Cli Skill Active: <skill-name> — 整活开工，但不整虚的
+Peaks-Cli Role Chain: <PRD → RD → QA → SC, or single role>
+Peaks-Cli Mode: <Solo | Assisted | Swarm | Strict | Economy>
+Peaks-Cli Current Gate: <confirmation | dry-run | coverage | QA | commit boundary | handoff>
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+Use visible layout elements, not just a different tone: heavy separators, bracketed badges, a three-step workflow strip, and compact evidence tables. Then include a short process preview before doing work:
+
+```markdown
+Peaks-Cli [流程] ① <current role action>  →  ② <next gate or validation>  →  ③ <handoff / artifact / follow-up>
+```
+
+For swarm or economy mode, add a compact worker table when useful:
+
+```markdown
+| Peaks-Cli Worker | Scope | Model/Cost lane | Output | Stop condition |
+| --- | --- | --- | --- | --- |
+| RD-1 | <subsystem> | <high/economy/configured provider> | <artifact> | <done signal> |
+```
+
+For final evidence, prefer this visual block:
+
+```markdown
+┌─ Peaks-Cli Evidence ─────────────────────
+│ Commands: <only commands that matter>
+│ Artifacts: <paths or none>
+│ Changed: <files or none>
+│ Blocker: <blocker or none>
+│ Next: <one next action>
+└──────────────────────────────────────────
+```
+
+For continuing turns in the same Peaks-Cli workflow, use a compact status header instead of the full banner:
+
+```markdown
+Peaks-Cli Skill: <skill-name> | Peaks-Cli Gate: <current gate> | Next: <one short action>
+```
+
+Structure active Peaks-Cli responses around:
+
+1. **Peaks-Cli Role** — name the active Peaks-Cli role or role chain, for example PRD → RD → QA → SC.
+2. **Peaks-Cli Mode** — state whether the workflow is Solo, Assisted, Swarm, Strict, or Economy.
+3. **Peaks-Cli Current Gate** — show the current required gate: product confirmation, RD dry-run, coverage, QA acceptance, commit boundary, or handoff.
+4. **Action** — describe the immediate next action in one short sentence before tool use.
+5. **Peaks-Cli Evidence** — end with only the evidence that matters: commands, artifacts, changed files, blockers, and next action.
+
+Do not produce long narrative logs. Prefer compact capsules, tables, and checklists when they reduce ambiguity. For unrelated non-Peaks tasks, do not show the banner.
+
+## Peaks-Cli + GStack alignment
+
+Use gstack as a workflow reference for `Think → Plan → Build → Review → Test → Ship → Reflect`, but keep Peaks-Cli as the authority:
+
+- Think maps to Peaks-Cli PRD and TXT context.
+- Plan maps to Peaks-Cli RD/UI planning, risk matrices, and slice contracts.
+- Build maps to RD implementation under strict specs.
+- Review maps to code review, design review, and security review.
+- Test maps to QA regression and acceptance evidence.
+- Ship maps to SC commit boundaries, sync state, and rollback points.
+- Reflect maps to TXT lessons and reusable memory candidates.
+
+Do not imply that gstack commands are available unless the project has explicitly installed or exposed them.
+
+## Peaks-Cli Swarm development mode
+
+Use Swarm mode for broad, parallelizable work with separable responsibilities. When recommending or running swarm work:
+
+- split workers by role, risk, or subsystem;
+- give each worker a bounded brief, expected artifact, and stop condition;
+- require a reducer pass that merges findings, removes conflicts, and chooses the smallest safe implementation;
+- keep shared-state actions, commits, pushes, deploys, and external messages behind explicit confirmation;
+- report worker outputs as a compact matrix: worker, scope, result, blocker, next action.
+
+Prefer parallel agents only for independent work. Do not duplicate searches or reviews already assigned to a worker.
+
+## Peaks-Cli Economy mode
+
+Use Economy mode when the user asks for low-cost execution or when the task is broad but low-risk. In Economy mode:
+
+- reserve high-capability models for architecture, reducer decisions, security-sensitive work, and final review;
+- route routine summarization, first-pass classification, repetitive inspection, and draft generation to cheaper available workers or providers when the environment supports them;
+- treat MiniMax and similar low-cost models as candidate worker backends only when the current toolchain exposes them or the user authorizes that routing;
+- never claim MiniMax or another external model was used unless an actual configured tool or agent invocation used it;
+- escalate from Economy to Strict when the task touches security, destructive operations, data loss risk, releases, or unclear requirements.
+
+When explaining Economy mode, separate **available now** from **recommended if configured**.
+
+## Peaks-Cli RD code-output rule
+
+When the active role is Peaks-Cli RD and code is produced or modified, require repeated dry-runs:
+
+1. run applicable Peaks-Cli standards dry-runs before planning or implementation;
+2. rerun relevant dry-runs after each meaningful slice or standards-affecting decision;
+3. rerun before handoff, review, or commit-boundary work;
+4. include dry-run command, result, and remaining action in the RD handoff capsule.
+
+If a dry-run cannot be executed, state the blocker and keep it as the next action rather than silently skipping it.
+
+## Peaks-Cli Output examples
+
+### Active Peaks-Cli skill
+
+```markdown
+Peaks-Cli Role: RD → QA
+Peaks-Cli Mode: Swarm
+Peaks-Cli Current Gate: RD dry-run before implementation
+Action: I will run standards dry-runs, then split workers by subsystem.
+
+Peaks-Cli Evidence:
+- Commands: ...
+- Artifacts: ...
+- Blocker: none
+- Next: reducer review
+```
+
+### Non-Peaks task
+
+Use normal concise Claude Code responses without the Peaks-Cli role/mode/gate wrapper.

package/package.json

@@ -0,0 +1,101 @@
+{
+  "name": "peaks-loop",
+  "version": "3.0.0",
+  "description": "Loop Engineering CLI — workflow primitive / loop guards / evaluators / slice orchestration",
+  "author": "SquabbyZ",
+  "license": "MIT",
+  "type": "module",
+  "packageManager": "pnpm@10.11.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SquabbyZ/peaks-cli.git"
+  },
+  "homepage": "https://github.com/SquabbyZ/peaks-cli",
+  "bugs": {
+    "url": "https://github.com/SquabbyZ/peaks-cli/issues"
+  },
+  "bin": {
+    "peaks": "./bin/peaks.js"
+  },
+  "files": [
+    "bin/peaks.js",
+    "dist/src/cli/index.js",
+    "dist/src/**/*.js",
+    "dist/src/**/*.d.ts",
+    "scripts/clean-dist.mjs",
+    "scripts/sync-version.mjs",
+    "scripts/install-skills.mjs",
+    "scripts/watch.mjs",
+    "skills/**",
+    "!skills/**/test-prompts.json",
+    "!skills/**/.DS_Store",
+    "output-styles/**",
+    "agents/**",
+    "schemas/*.json",
+    ".claude-plugin/**",
+    "README.md",
+    "README-en.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node ./scripts/sync-version.mjs && node ./scripts/clean-dist.mjs && tsc -p tsconfig.json",
+    "prepack": "npm run build",
+    "prepublishOnly": "node scripts/prepublish-build.mjs",
+    "prepublish": "node ./scripts/sync-version.mjs",
+    "postinstall": "node ./scripts/install-skills.mjs",
+    "predev": "node ./scripts/sync-version.mjs",
+    "dev": "tsx src/cli/index.ts",
+    "dev:watch": "node ./scripts/watch.mjs",
+    "pretest": "node ./scripts/sync-version.mjs",
+    "test": "node ./scripts/lint/silent-warning-detector.mjs && vitest run",
+    "lint:silent-warning": "node ./scripts/lint/silent-warning-detector.mjs",
+    "test:race": "vitest run --no-file-parallelism tests/unit/g8-shared-channel.test.ts tests/unit/dispatch-record-writer.test.ts tests/unit/services/retrospective/heartbeat.test.ts tests/unit/cli/commands/share-commands.test.ts",
+    "test:replay": "node scripts/fixture-capture-setup.mjs && vitest run tests/unit/replay tests/unit/fixture",
+    "fixture:capture-setup": "node scripts/fixture-capture-setup.mjs",
+    "test:coverage": "vitest run --coverage",
+    "test:coverage:workflow": "vitest run --coverage --coverage.include='src/services/workflow/plan-*.ts' tests/unit/services/workflow/",
+    "pretest:coverage": "node ./scripts/pretest-coverage.mjs",
+    "schema:generate": "node scripts/generate-context-schema.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit && vitest run --coverage --coverage.include='src/services/workflow/plan-*.ts' tests/unit/services/workflow/",
+    "mut:run": "peaks mut run --project . --out mut-report.json",
+    "mut:scan": "peaks mut asserts --in mut-report.json",
+    "audit:prose-ratio": "peaks audit prose-ratio --project ."
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": []
+  },
+  "dependencies": {
+    "@colbymchenry/codegraph": "0.7.10",
+    "commander": "^12.1.0",
+    "fzf": "^0.5.2",
+    "headroom-ai": "0.22.4",
+    "yaml": "^2.9.0",
+    "zod": "^3.25.76"
+  },
+  "peerDependencies": {
+    "@alibaba-group/open-code-review": "1.3.1"
+  },
+  "peerDependenciesMeta": {
+    "@alibaba-group/open-code-review": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@jridgewell/trace-mapping": "^0.3.31",
+    "@stryker-mutator/core": "^8.7.1",
+    "@stryker-mutator/typescript-checker": "^8.7.1",
+    "@types/node": "^22.10.2",
+    "@vitest/coverage-v8": "^2.1.8",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8",
+    "zod-to-json-schema": "^3.25.2"
+  }
+}

package/schemas/approval-record.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Peaks Approval Record",
+  "type": "object",
+  "required": ["approvedArtifact", "decision"],
+  "properties": {
+    "approvedBy": { "type": "string" },
+    "approvedAt": { "type": "string" },
+    "approvedArtifact": { "type": "string" },
+    "decision": { "type": "string" },
+    "acceptedRisks": { "type": "array" },
+    "conditions": { "type": "array" }
+  }
+}

package/schemas/artifact-manifest.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Peaks Artifact Manifest",
+  "type": "object",
+  "required": ["artifactId", "artifactType", "ownerSkill", "status"],
+  "properties": {
+    "artifactId": { "type": "string" },
+    "artifactType": { "type": "string" },
+    "ownerSkill": { "type": "string" },
+    "scenario": { "type": "string" },
+    "status": { "type": "string" },
+    "inputs": { "type": "array", "items": { "type": "string" } },
+    "outputs": { "type": "array", "items": { "type": "string" } },
+    "evidence": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/schemas/artifact-retention-report.schema.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Peaks Artifact Retention Report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["sliceId", "prdArtifacts", "rdArtifacts", "qaArtifacts", "retentionStatus"],
+  "properties": {
+    "sliceId": { "type": "string", "pattern": "^(?!\\.{1,2}$)[A-Za-z0-9._-]{1,128}$" },
+    "prdArtifacts": { "$ref": "#/$defs/artifactPaths" },
+    "rdArtifacts": { "$ref": "#/$defs/artifactPaths" },
+    "qaArtifacts": { "$ref": "#/$defs/artifactPaths" },
+    "coverageArtifacts": { "$ref": "#/$defs/artifactPaths" },
+    "reviewArtifacts": { "$ref": "#/$defs/artifactPaths" },
+    "codeChanges": { "type": "array", "maxItems": 500, "items": { "$ref": "#/$defs/repoRelativePath" } },
+    "retentionStatus": { "type": "string", "enum": ["local-ready", "pending", "explicitly-committed", "rolled-back"] },
+    "commitHash": { "anyOf": [{ "type": "string", "pattern": "^[A-Fa-f0-9]{7,64}$" }, { "type": "null" }] },
+    "rollbackPoint": { "anyOf": [{ "type": "string", "pattern": "^[A-Fa-f0-9]{7,64}$" }, { "type": "null" }] }
+  },
+  "$defs": {
+    "artifactPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512,
+      "pattern": "^(?!.*(?:^|/)\\.{1,2}(?:/|$))(prd|rd|ui|qa|sc|txt)/[A-Za-z0-9._-]+(?:/[A-Za-z0-9._-]+)*$"
+    },
+    "artifactPaths": {
+      "type": "array",
+      "maxItems": 500,
+      "items": { "$ref": "#/$defs/artifactPath" }
+    },
+    "repoRelativePath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512,
+      "pattern": "^(?!/)(?![A-Za-z]:)(?!.*\\\\)(?!.*://)(?!.*(?:^|/)\\.{1,2}(?:/|$))[A-Za-z0-9._/-]+$"
+    }
+  }
+}

package/schemas/artifact-workspace.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Peaks Artifact Workspace",
+  "type": "object",
+  "required": ["workspaceId", "localPath"],
+  "properties": {
+    "workspaceId": { "type": "string" },
+    "artifactRepo": {
+      "type": "object",
+      "required": ["provider", "owner", "name"],
+      "properties": {
+        "provider": { "type": "string", "enum": ["github", "gitlab"] },
+        "owner": { "type": "string" },
+        "name": { "type": "string" },
+        "url": { "type": "string", "format": "uri" }
+      }
+    },
+    "localPath": { "type": "string" },
+    "lastSync": { "type": "string", "format": "date-time" },
+    "syncStatus": { "type": "string", "enum": ["synced", "pending", "out-of-sync", "unknown"] }
+  }
+}

package/schemas/capability-availability.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Peaks Capability Availability",
+  "type": "object",
+  "required": ["capabilityId", "type", "status", "requiredFor", "fallback"],
+  "properties": {
+    "capabilityId": { "type": "string" },
+    "type": {
+      "type": "string",
+      "enum": ["skill", "mcp", "cli", "agent", "profile"]
+    },
+    "status": {
+      "type": "string",
+      "enum": ["available", "missing", "installable", "disabled", "unknown"]
+    },
+    "requiredFor": { "type": "array", "items": { "type": "string" } },
+    "installPlan": {
+      "type": "object",
+      "properties": {
+        "available": { "type": "boolean" },
+        "commandPreview": { "type": "string" },
+        "requiresApproval": { "type": "boolean" }
+      }
+    },
+    "fallback": {
+      "type": "object",
+      "required": ["mode", "qualityImpact"],
+      "properties": {
+        "mode": { "type": "string" },
+        "qualityImpact": { "type": "string" },
+        "nextAction": { "type": "string" }
+      }
+    },
+    "risk": { "type": "string", "enum": ["low", "medium", "high"] }
+  }
+}

package/schemas/capability-item.schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Peaks Capability Item",
+  "type": "object",
+  "required": ["capabilityId", "sourceId", "itemType", "category", "workflows", "riskLevel", "fallback"],
+  "properties": {
+    "capabilityId": { "type": "string" },
+    "sourceId": { "type": "string" },
+    "name": { "type": "string" },
+    "itemType": {
+      "type": "string",
+      "enum": ["skill", "agent", "mcp", "rule", "hook", "template", "workflow", "doc", "cli"]
+    },
+    "category": { "type": "string" },
+    "workflows": { "type": "array", "items": { "type": "string" } },
+    "audience": { "type": "array", "items": { "type": "string" } },
+    "riskLevel": { "type": "string", "enum": ["low", "medium", "high"] },
+    "inputContract": { "type": "string" },
+    "outputContract": { "type": "string" },
+    "fallback": {
+      "type": "object",
+      "required": ["mode", "qualityImpact"],
+      "properties": {
+        "mode": { "type": "string" },
+        "qualityImpact": { "type": "string" },
+        "nextAction": { "type": "string" }
+      }
+    },
+    "presentation": {
+      "type": "object",
+      "properties": {
+        "displayName": { "type": "object" },
+        "description": { "type": "object" }
+      }
+    }
+  }
+}

package/schemas/capability-source.schema.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Peaks Capability Source",
+  "type": "object",
+  "required": ["sourceId", "sourceType", "title", "url", "discoveryStatus", "items"],
+  "properties": {
+    "sourceId": { "type": "string" },
+    "sourceType": {
+      "type": "string",
+      "enum": ["repo", "skills-package", "mcp-collection", "website", "local-install"]
+    },
+    "title": { "type": "string" },
+    "url": { "type": "string" },
+    "trustSignals": {
+      "type": "object",
+      "properties": {
+        "sourceReputation": { "type": "string" },
+        "stars": { "type": "number" },
+        "installs": { "type": "number" },
+        "maintainer": { "type": "string" },
+        "notes": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "discoveryStatus": {
+      "type": "string",
+      "enum": ["unscanned", "indexed", "verified", "deprecated"]
+    },
+    "items": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/schemas/change-impact.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Peaks Change Impact",
+  "type": "object",
+  "required": ["changeId", "sourceArtifacts", "affectedModules"],
+  "properties": {
+    "changeId": { "type": "string" },
+    "sourceArtifacts": { "type": "array", "items": { "type": "string" } },
+    "affectedModules": { "type": "array", "items": { "type": "string" } },
+    "affectedFiles": { "type": "array", "items": { "type": "string" } },
+    "qaImpact": { "type": "object" },
+    "riskImpact": { "type": "object" },
+    "syncPointers": { "type": "object" }
+  }
+}

package/schemas/context-capsule.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Peaks Context Capsule",
+  "type": "object",
+  "required": ["sourceSkill", "audience", "purpose"],
+  "properties": {
+    "sourceSkill": { "type": "string" },
+    "audience": { "type": "array", "items": { "type": "string" } },
+    "purpose": { "type": "string" },
+    "confirmedDecisions": { "type": "array" },
+    "assumptions": { "type": "array" },
+    "discardedOptions": { "type": "array" },
+    "risks": { "type": "array" },
+    "staleness": { "type": "object" }
+  }
+}