@pareto4/pp-core 1.8.1 → 1.8.2

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pp-core",
   "displayName": "PP Core",
-  "version": "1.8.1",
+  "version": "1.8.2",
   "description": "PP Core is a meta-prompting, context engineering, and spec-driven development system for AI coding agents.",
   "author": {
     "name": "pareto4",

package/NOTICE

@@ -0,0 +1,23 @@
+pp-core
+=======
+
+pp-core is based on gsd-core by Open GSD.
+
+## Upstream Attribution
+
+Copyright (c) 2026 Open GSD
+
+gsd-core is licensed under the MIT License.
+Source: https://github.com/open-gsd/gsd-core
+npm package: @opengsd/gsd-core @ version 1.5.0
+
+The full text of the MIT License is reproduced in the LICENSE file at the root of
+this repository.
+
+## Fork Information
+
+pp-core is a hard fork of gsd-core v1.5.0, maintained by The Pareto Project.
+It is not affiliated with or endorsed by OpenGSD.
+
+pp-core diverges from gsd-core as of 2026-06-24. The Pareto Project develops and
+maintains pp-core independently; no upstream merges from gsd-core are planned.

package/README.md

@@ -87,10 +87,16 @@ Troubleshooting? See [docs/how-to/recover-and-troubleshoot.md](docs/how-to/recov
 
 ---
 
-## License
+## License & Attribution
 
 MIT License. See [LICENSE](LICENSE) for details.
 
+pp-core is a hard fork of [gsd-core](https://github.com/open-gsd/gsd-core) by
+Open GSD (MIT), rebranded and extended by The Pareto Project. The original
+copyright and permission notice are preserved in [LICENSE](LICENSE), and
+upstream attribution is recorded in [NOTICE](NOTICE) — both files ship in the
+npm package and in every installed footprint.
+
 ---
 
 <div align="center">

package/bin/install.js

@@ -10434,6 +10434,31 @@ function install(isGlobal, runtime = 'claude', options = {}) {
     }
   }
 
+  // Copy NOTICE (MIT attribution to upstream gsd-core) — the installed
+  // footprint is a distributed copy, so the attribution must travel with it.
+  const noticeSrc = path.join(src, 'NOTICE');
+  const noticeDest = path.join(targetDir, 'pp-core', 'NOTICE');
+  if (fs.existsSync(noticeSrc)) {
+    fs.copyFileSync(noticeSrc, noticeDest);
+    if (verifyFileInstalled(noticeDest, 'NOTICE')) {
+      console.log(`  ${green}✓${reset} Installed NOTICE`);
+    } else {
+      failures.push('NOTICE');
+    }
+  }
+
+  // Copy LICENSE alongside it for the same reason.
+  const licenseSrc = path.join(src, 'LICENSE');
+  const licenseDest = path.join(targetDir, 'pp-core', 'LICENSE');
+  if (fs.existsSync(licenseSrc)) {
+    fs.copyFileSync(licenseSrc, licenseDest);
+    if (verifyFileInstalled(licenseDest, 'LICENSE')) {
+      console.log(`  ${green}✓${reset} Installed LICENSE`);
+    } else {
+      failures.push('LICENSE');
+    }
+  }
+
   // Write VERSION file
   const versionDest = path.join(targetDir, 'pp-core', 'VERSION');
   fs.writeFileSync(versionDest, pkg.version);

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "pp-core",
-  "version": "1.8.1",
+  "version": "1.8.2",
   "description": "PP Core — a meta-prompting, context engineering, and spec-driven development system for AI coding agents. Loads pp-core's operating context into every Gemini CLI session.",
   "contextFileName": "GEMINI.md"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pareto4/pp-core",
-  "version": "1.8.1",
+  "version": "1.8.2",
   "description": "Pareto pp-core — The Pareto Project's AI-assisted engineering framework: meta-prompting, context engineering, and spec-driven development for AI coding agents.",
   "bin": {
     "pp-core": "bin/install.js",
@@ -8,6 +8,8 @@
     "pp_run": "pp-core/bin/pp_run"
   },
   "files": [
+    "LICENSE",
+    "NOTICE",
     "bin",
     "commands",
     "pp-core",

package/pp-core/bin/lib/init.cjs

@@ -1825,9 +1825,9 @@ function buildSkillManifest(cwd, skillsDir = null) {
             // Nested layout: <entry>/skills/<stem>/SKILL.md
             // Used by cline, qwen, hermes, augment, trae, antigravity (#69 nested=true).
             // Descend exactly one level into <entry>/skills/ — no deeper recursion.
-            // Scope to gsd-ns-* routers only: never vacuum up an unrelated user skill
-            // that happens to have its own `skills/` subdirectory.
-            if (!entry.name.startsWith('gsd-ns-'))
+            // Scope to pp-ns-* routers (plus legacy gsd-ns-*) only: never vacuum up an
+            // unrelated user skill that happens to have its own `skills/` subdirectory.
+            if (!entry.name.startsWith('pp-ns-') && !entry.name.startsWith('gsd-ns-'))
                 continue;
             const nestedSkillsDir = node_path_1.default.join(rootPath, entry.name, 'skills');
             let nestedEntries = [];
@@ -1859,7 +1859,7 @@ function buildSkillManifest(cwd, skillsDir = null) {
         const rootCmp = a.root.localeCompare(b.root);
         return rootCmp !== 0 ? rootCmp : a.name.localeCompare(b.name);
     });
-    const gsdSkillsInstalled = skills.some((skill) => skill.name.startsWith('gsd-'));
+    const gsdSkillsInstalled = skills.some((skill) => skill.name.startsWith('pp-') || skill.name.startsWith('gsd-'));
     return {
         skills,
         roots,

package/pp-core/bin/lib/installer-migration-report.cjs

@@ -151,7 +151,7 @@ function classifyPromptUserAction(action) {
     if (/^pp-core\/sdk\/(dist|src)\//.test(relPath)) {
         return { category: 'stale-sdk-build-artifact', choice: 'remove' };
     }
-    if (/^skills\/gsd-[^/]+\/SKILL\.md$/.test(relPath)) {
+    if (/^skills\/(?:pp|gsd)-[^/]+\/SKILL\.md$/.test(relPath)) {
         return { category: 'user-facing-skill', choice: 'keep' };
     }
     // #3610 / #3628: bundled GSD hooks shipped under `hooks/`. The whitelist

package/pp-core/bin/lib/runtime-name-policy.cjs

@@ -43,7 +43,6 @@ function normalizeRuntimeToken(value) {
 function loadAliasManifest() {
     const manifestCandidates = [
         node_path_1.default.resolve(__dirname, '..', 'shared', 'runtime-aliases.manifest.json'),
-        node_path_1.default.resolve(__dirname, '../../../sdk/shared/runtime-aliases.manifest.json'),
     ];
     for (const manifestPath of manifestCandidates) {
         try {

package/pp-core/bin/lib/surface.cjs

@@ -439,11 +439,11 @@ function _syncGsdDir(stagedDir, destDir, kind, manifest) {
         }
         // Prune stale GSD-owned files not in the staged set, preserving user-owned files
         // (mirrors install's prefix-scoped _removeGsdEntries):
-        //   - agents: only gsd-* are GSD-owned
+        //   - agents: only `${kindPrefix}`-prefixed (plus legacy gsd-*) are GSD-owned
         //   - flat command dirs: only `${kindPrefix}`-prefixed are GSD-owned
         //   - namespaced command dirs: the whole dir is GSD-owned
         for (const file of node_fs_1.default.readdirSync(destDir).filter(f => f.endsWith('.md'))) {
-            if (kindName === 'agents' && !file.startsWith('gsd-'))
+            if (kindName === 'agents' && !(kindPrefix && file.startsWith(kindPrefix)) && !file.startsWith('gsd-'))
                 continue;
             if (kindName === 'commands' && !namespacedByDir && kindPrefix && !file.startsWith(kindPrefix))
                 continue;

package/pp-core/references/workstream-flag.md

@@ -68,6 +68,19 @@ All workflow routing commands include `${GSD_WS}` which:
 This ensures workstream scope chains automatically through the workflow:
 `new-milestone → discuss-phase → plan-phase → execute-phase → transition`
 
+### Substitution rule (user-facing output and Skill/Task args)
+
+Outside executed bash blocks, `${GSD_WS}` / `{GSD_WS}` is a placeholder, not a
+shell variable — nothing expands it automatically. When a workflow emits a
+routing or "Next:" command, or passes args to `Skill()`/`Task()`, Claude must
+substitute the placeholder itself:
+
+- Workstream active → replace with `--ws <name>`
+- Flat mode → remove the placeholder entirely (and any doubled whitespace)
+
+Never print the literal token `${GSD_WS}` in a user-facing command — a pasted
+command containing it breaks in the shell.
+
 ## Directory Structure
 
 ```

package/pp-core/workflows/discuss-phase/modes/chain.md

@@ -1,5 +1,10 @@
 # --chain mode — interactive discuss, then auto-advance
 
+<workstream_flag_substitution>
+`${GSD_WS}` / `{GSD_WS}` in emitted "Next:" commands and `Skill()` args and agent dispatch prompts is a placeholder, not a shell variable — nothing expands it automatically. Substitute the active `--ws <name>`, or remove it entirely in flat mode. Never print the literal token in user-facing output. See `pp-core/references/workstream-flag.md` § Substitution rule.
+</workstream_flag_substitution>
+
+
 > **Lazy-loaded.** Read this file from `workflows/discuss-phase.md` when
 > `--chain` is present in `$ARGUMENTS`, or when the parent's `auto_advance`
 > step needs to dispatch to plan-phase under `--auto`.

package/pp-core/workflows/discuss-phase.md

@@ -11,6 +11,10 @@ Extract implementation decisions that downstream agents need. Analyze the phase
 You are a thinking partner, not an interviewer. The user is the visionary — you are the builder. Your job is to capture decisions that will guide research and planning, not to figure out implementation yourself.
 </purpose>
 
+<workstream_flag_substitution>
+`${GSD_WS}` / `{GSD_WS}` in emitted "Next:" commands and `Skill()` args and agent dispatch prompts is a placeholder, not a shell variable — nothing expands it automatically. Substitute the active `--ws <name>`, or remove it entirely in flat mode. Never print the literal token in user-facing output. See `pp-core/references/workstream-flag.md` § Substitution rule.
+</workstream_flag_substitution>
+
 <required_reading>
 @~/.claude/pp-core/references/domain-probes.md
 @~/.claude/pp-core/references/gate-prompts.md

package/pp-core/workflows/execute-phase.md

@@ -9,6 +9,10 @@ consumes: PLAN.md
 Execute all plans in a phase using wave-based parallel execution. Orchestrator stays lean — delegates plan execution to subagents.
 </purpose>
 
+<workstream_flag_substitution>
+`${GSD_WS}` / `{GSD_WS}` in emitted "Next:" commands and `Skill()` args and agent dispatch prompts is a placeholder, not a shell variable — nothing expands it automatically. Substitute the active `--ws <name>`, or remove it entirely in flat mode. Never print the literal token in user-facing output. See `pp-core/references/workstream-flag.md` § Substitution rule.
+</workstream_flag_substitution>
+
 <core_principle>
 Orchestrator coordinates, not executes. Each subagent loads the full execute-plan context. Orchestrator: discover plans → analyze deps → group waves → spawn agents → handle checkpoints → collect results.
 </core_principle>

package/pp-core/workflows/new-milestone.md

@@ -4,6 +4,10 @@ Start a new milestone cycle for an existing project. Loads project context, gath
 
 </purpose>
 
+<workstream_flag_substitution>
+`${GSD_WS}` / `{GSD_WS}` in emitted "Next:" commands and `Skill()` args and agent dispatch prompts is a placeholder, not a shell variable — nothing expands it automatically. Substitute the active `--ws <name>`, or remove it entirely in flat mode. Never print the literal token in user-facing output. See `pp-core/references/workstream-flag.md` § Substitution rule.
+</workstream_flag_substitution>
+
 <required_reading>
 
 Read all files referenced by the invoking prompt's execution_context before starting.

package/pp-core/workflows/plan-phase.md

@@ -9,6 +9,10 @@ consumes: CONTEXT.md
 Create executable phase prompts (PLAN.md files) for a roadmap phase with integrated research and verification. Default flow: Research (if needed) -> Plan -> Verify -> Done. Orchestrates pp-phase-researcher, pp-planner, and pp-plan-checker agents with a revision loop (max 3 iterations).
 </purpose>
 
+<workstream_flag_substitution>
+`${GSD_WS}` / `{GSD_WS}` in emitted "Next:" commands and `Skill()` args and agent dispatch prompts is a placeholder, not a shell variable — nothing expands it automatically. Substitute the active `--ws <name>`, or remove it entirely in flat mode. Never print the literal token in user-facing output. See `pp-core/references/workstream-flag.md` § Substitution rule.
+</workstream_flag_substitution>
+
 <required_reading>
 Read all files referenced by the invoking prompt's execution_context before starting.
 

package/pp-core/workflows/progress.md

@@ -2,6 +2,10 @@
 Check project progress, summarize recent work and what's ahead, then intelligently route to the next action — either executing an existing plan or creating the next one. Provides situational awareness before continuing work.
 </purpose>
 
+<workstream_flag_substitution>
+`${GSD_WS}` / `{GSD_WS}` in emitted "Next:" commands and `Skill()` args and agent dispatch prompts is a placeholder, not a shell variable — nothing expands it automatically. Substitute the active `--ws <name>`, or remove it entirely in flat mode. Never print the literal token in user-facing output. See `pp-core/references/workstream-flag.md` § Substitution rule.
+</workstream_flag_substitution>
+
 <required_reading>
 Read all files referenced by the invoking prompt's execution_context before starting.
 </required_reading>

package/pp-core/workflows/quick.md

@@ -12,6 +12,10 @@ With `--research` flag: spawns a focused research agent before planning. Investi
 Granular flags are composable: `--discuss --research --validate` gives the same result as `--full`.
 </purpose>
 
+<workstream_flag_substitution>
+`${GSD_WS}` / `{GSD_WS}` in emitted "Next:" commands and `Skill()` args and agent dispatch prompts is a placeholder, not a shell variable — nothing expands it automatically. Substitute the active `--ws <name>`, or remove it entirely in flat mode. Never print the literal token in user-facing output. See `pp-core/references/workstream-flag.md` § Substitution rule.
+</workstream_flag_substitution>
+
 <required_reading>
 Read all files referenced by the invoking prompt's execution_context before starting.
 </required_reading>

package/pp-core/workflows/resume-project.md

@@ -10,6 +10,10 @@ Use this workflow when:
 Instantly restore full project context so "Where were we?" has an immediate, complete answer.
 </purpose>
 
+<workstream_flag_substitution>
+`${GSD_WS}` / `{GSD_WS}` in emitted "Next:" commands and `Skill()` args and agent dispatch prompts is a placeholder, not a shell variable — nothing expands it automatically. Substitute the active `--ws <name>`, or remove it entirely in flat mode. Never print the literal token in user-facing output. See `pp-core/references/workstream-flag.md` § Substitution rule.
+</workstream_flag_substitution>
+
 <required_reading>
 @~/.claude/pp-core/references/continuation-format.md
 </required_reading>

package/pp-core/workflows/ship.md

@@ -9,6 +9,10 @@ consumes: UAT.md
 Create a pull request from completed phase/milestone work, generate a rich PR body from planning artifacts, optionally run code review, and prepare for merge. Closes the plan → execute → verify → ship loop.
 </purpose>
 
+<workstream_flag_substitution>
+`${GSD_WS}` / `{GSD_WS}` in emitted "Next:" commands and `Skill()` args and agent dispatch prompts is a placeholder, not a shell variable — nothing expands it automatically. Substitute the active `--ws <name>`, or remove it entirely in flat mode. Never print the literal token in user-facing output. See `pp-core/references/workstream-flag.md` § Substitution rule.
+</workstream_flag_substitution>
+
 <required_reading>
 Read all files referenced by the invoking prompt's execution_context before starting.
 </required_reading>

package/pp-core/workflows/transition.md

@@ -34,6 +34,10 @@ Mark current phase complete and advance to next. This is the natural point where
 
 </purpose>
 
+<workstream_flag_substitution>
+`${GSD_WS}` / `{GSD_WS}` in emitted "Next:" commands and `Skill()` args and agent dispatch prompts is a placeholder, not a shell variable — nothing expands it automatically. Substitute the active `--ws <name>`, or remove it entirely in flat mode. Never print the literal token in user-facing output. See `pp-core/references/workstream-flag.md` § Substitution rule.
+</workstream_flag_substitution>
+
 <process>
 
 <step name="load_project_state" priority="first">

package/pp-core/workflows/validate-phase.md

@@ -2,6 +2,10 @@
 Audit Nyquist validation gaps for a completed phase. Generate missing tests. Update VALIDATION.md.
 </purpose>
 
+<workstream_flag_substitution>
+`${GSD_WS}` / `{GSD_WS}` in emitted "Next:" commands and `Skill()` args and agent dispatch prompts is a placeholder, not a shell variable — nothing expands it automatically. Substitute the active `--ws <name>`, or remove it entirely in flat mode. Never print the literal token in user-facing output. See `pp-core/references/workstream-flag.md` § Substitution rule.
+</workstream_flag_substitution>
+
 <required_reading>
 @~/.claude/pp-core/references/ui-brand.md
 </required_reading>