skillpacks 0.1.0 → 0.1.1

package/AGENTS.md

@@ -7,7 +7,6 @@
 - Verification is mandatory, but routine no-op verification runs inside the active execution/shipping step. Enter plan mode for non-trivial remediation or new work discovered by verification, not for validation that already has clear commands and no expected source changes.
 - Write detailed specs upfront to reduce ambiguity
 - In Codex: use `update_plan` in Default mode and `request_user_input` only when already in Plan mode
-- Do not assume a Claude-style clear-context-on-accept flow or related JSON setting exists
 
 ### 2. Subagent Strategy
 - Use subagents only when the active Codex tool instructions allow them.

package/CLAUDE.md

@@ -7,7 +7,6 @@
 - Verification is mandatory, but routine no-op verification runs inside the active execution/shipping step. Enter plan mode for non-trivial remediation or new work discovered by verification, not for validation that already has clear commands and no expected source changes.
 - Write detailed specs upfront to reduce ambiguity
 - In Codex: use `update_plan` in Default mode and `request_user_input` only when already in Plan mode
-- Do not assume a Claude-style clear-context-on-accept flow or related JSON setting exists
 
 ### 2. Subagent Strategy
 - Use subagents liberally to keep main context window clean
@@ -127,7 +126,7 @@ The alignment-page convention is authored in `docs/alignment-page-convention.md`
 
 **Visual rendering tiers.** Each alignment page has a rendering tier declared via `visual_tier` in SKILL.md frontmatter: `document` (default — text/tables only), `visual` (adds inline Canvas/SVG charts using `scripts/alignment-chart-snippets.js` as reference), or `prototype` (adds interactive components). The upgrade script injects tier-appropriate guidance into each skill's `ALIGNMENT-PAGE.md`.
 
-**Interview depth.** Skills declare `interview_depth` in SKILL.md frontmatter: `full` (4-phase terminal interview before alignment page), `light` (1-3 context questions + findings validation), or `none` (direct to research). The interview convention is defined in `docs/interview-convention.md`. All interviewing happens in the terminal before the alignment page is built.
+**Interview depth.** Skills declare `interview_depth` in SKILL.md frontmatter: `full` (4-phase terminal interview before alignment page), `light` (1-3 context questions + findings validation), or `none` (direct to research). The interview convention is defined in `docs/interview-convention.md`. All interviewing happens in the terminal before the alignment page is built. Confirmation manifests/checklists render inline as turn-final message text per the Manifest Visibility Rule in `docs/interview-convention.md`.
 
 **Glossary write-forward.** Skills with `type: research` or `type: analysis` automatically receive a glossary additions gate in their `ALIGNMENT-PAGE.md`. The gate renders proposed terms with per-term approve/edit/reject/flag controls. Only approved terms are appended to the target glossary during the confirmed-page write step.
 

package/README.md

@@ -42,17 +42,19 @@ cd ~/my-project
 
 ### npm CLI
 
-After the first public package is published, users can install from the current project directory without cloning this repository:
+With the published npm package, users can install from the current project directory without cloning this repository:
 
 ```bash
 cd ~/my-project
+npx skillpacks init
 npx skillpacks install devtool
 npx skillpacks install code-quality
 npx skillpacks install-deck game-afps
+npx skillpacks refresh
 npx skillpacks status
 ```
 
-`npx skillpacks` writes the same project-local files as `scripts/pack.sh`: `.agents/project.json`, `.claude/skills/*`, and `.codex/skills/*`. Package semver such as `skillpacks@0.1.0` selects the bundled skill snapshot; individual skill pins still use each skill's `version:` value through `skillpacks pin <skill> <version>`.
+`npx skillpacks init` installs the base skills for the current repository as project-local roots. `npx skillpacks install <pack-or-skill>` adds domain packs or individual pack skills. Both write project-local files: `.agents/project.json`, `.claude/skills/*`, and `.codex/skills/*`. Package semver such as `skillpacks@0.1.0` selects the bundled skill snapshot; `npx skillpacks refresh` recreates enabled base skills and packs from that snapshot. Individual skill pins still use each skill's `version:` value through `skillpacks pin <skill> <version>`.
 
 ## Initialization
 
@@ -60,13 +62,15 @@ npx skillpacks status
 ./init.sh
 ```
 
-`init.sh` initializes only the global core skills:
+`init.sh` initializes only user-home global core skills:
 
-- `global/claude/*` → `~/.claude/skills/*`
-- `global/codex/*` → `~/.codex/skills/*`
+- `global/claude/*` -> `~/.claude/skills/*`
+- `global/codex/*` -> `~/.codex/skills/*`
 
 It does **not** install `packs/*` globally.
 
+For npm consumers, prefer `npx skillpacks init` in each target repository. That installs the same base skill sources project-locally and records `base_skills: true` in `.agents/project.json`, so later `npx skillpacks refresh` updates them from the package version being run. Use `npx skillpacks init-global` only when you explicitly want user-home global installs.
+
 To remove repo-managed global skill installs:
 
 ```bash
@@ -102,7 +106,7 @@ scripts/pack.sh remove design-system
 
 `scripts/pack.sh install <name>` accepts either a pack name or a skill name from any pack. Pack names install every skill in the pack. Skill names install only that one project-local skill and record it under `.agents/project.json` `enabled_skills`.
 
-The npm CLI also supports equivalent project-local installs after publication: `npx skillpacks install <pack-or-skill>`, `npx skillpacks remove <pack-or-skill>`, `npx skillpacks refresh`, `npx skillpacks doctor`, and deck installation from manifest metadata including `npx skillpacks install-deck vard`, `npx skillpacks install-deck ord`, `npx skillpacks install-deck business-afps`, `npx skillpacks install-deck devtool-afps`, and `npx skillpacks install-deck game-afps`.
+The npm CLI also supports equivalent project-local installs: `npx skillpacks install <pack-or-skill>`, `npx skillpacks remove <pack-or-skill>`, `npx skillpacks refresh`, `npx skillpacks doctor`, and deck installation from manifest metadata including `npx skillpacks install-deck vard`, `npx skillpacks install-deck ord`, `npx skillpacks install-deck business-afps`, `npx skillpacks install-deck devtool-afps`, and `npx skillpacks install-deck game-afps`.
 
 `scripts/pack.sh list-packs` is an internal subcommand used by Codex `$exec` routing (see `global/codex/exec/SKILL.md`). It prints enabled packs from `.agents/project.json` one per line with no decoration, distinct from the human-facing `list` above; prefer `list` or `status` for interactive use.
 
@@ -233,7 +237,7 @@ For SaaS, marketplaces, productivity tools, business applications, and enterpris
 Install only the current lane:
 
 ```text
-business-discovery: icp, enterprise-icp, competitive-analysis, customer-feedback,
+business-discovery: customer-discovery, enterprise-icp, competitive-analysis, customer-feedback,
 value-prop-canvas, lean-canvas, positioning
 
 customer-lifecycle: journey-map, onboarding-map, conversion-map,

package/bin/skillpacks.mjs

@@ -1,6 +1,14 @@
 #!/usr/bin/env node
 
 import { runSkillpacksCli } from '../src/cli/run-pack-script.mjs';
+import { startUpdateCheck, printUpdateNotice } from '../src/cli/update-check.mjs';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { join, dirname } from 'node:path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
+const checkPromise = startUpdateCheck();
 
 try {
   const exitCode = await runSkillpacksCli(process.argv.slice(2));
@@ -8,5 +16,7 @@ try {
 } catch (error) {
   const message = error instanceof Error ? error.message : String(error);
   console.error(`skillpacks: ${message}`);
-  process.exit(1);
+  process.exitCode = 1;
+} finally {
+  await printUpdateNotice(checkPromise, pkg.version);
 }