alignfirst 0.3.1 → 0.4.0

package/README.md

@@ -2,6 +2,8 @@
 
 The AlignFirst CLI provides collaborative software-development workflows, work files, and documentation discovery. Work files are organized by ticket and kept either git-ignored in the project or synchronized through a work-files repository.
 
+See the [product page](https://alignfirst.paroi.tech/skills) for a demonstration.
+
 ## Agent skills
 
 Nine Agent Skill stubs expose the CLI as commands in Claude Code, Codex, GitHub Copilot, and Cursor. Install them globally:
@@ -66,7 +68,7 @@ npm update -g alignfirst
 Temporarily install the setup-guide skill:
 
 ```sh
-npx skills add https://github.com/paleo/alignfirst --skill alignfirst-setup-guide
+npx skills add https://github.com/paleo/alignfirst --global --skill alignfirst-setup-guide
 ```
 
 Then ask your agent:
@@ -100,7 +102,7 @@ Run `alignfirst --help` for command usage or `alignfirst guide` to choose a prot
 Install the setup-guide skill and ask your agent to run its upgrade route:
 
 ```sh
-npx skills add https://github.com/paleo/alignfirst --skill alignfirst-setup-guide
+npx skills add https://github.com/paleo/alignfirst --global --skill alignfirst-setup-guide
 ```
 
 ```text

package/dist/commands/docmap.js

@@ -1,4 +1,4 @@
-import { main as docmapMain } from "@paleo/docmap";
+import { main as docmapMain } from "@alignfirst/docmap";
 export function runDocmap(ctx, args) {
     return docmapMain({
         argv: ["node", "docmap", ...args],

package/dist/commands/doctor.js

@@ -92,9 +92,9 @@ function inspectDocmap(ctx) {
 }
 function readDocmapVersion() {
     const require = createRequire(import.meta.url);
-    const pkg = require("@paleo/docmap/package.json");
+    const pkg = require("@alignfirst/docmap/package.json");
     if (!isRecord(pkg) || typeof pkg.version !== "string")
-        throw new Error("@paleo/docmap package.json has no version");
+        throw new Error("@alignfirst/docmap package.json has no version");
     return pkg.version;
 }
 function isRecord(value) {

package/dist/plans/catchup.js

@@ -7,7 +7,7 @@ const MAX_FILE_BYTES = 64 * 1024;
 const MAX_OUTPUT_BYTES = 30 * 1024;
 const PLAN_FILE = /^[A-Z]\d+-(?:main-plan|plan-.*)\.md$/;
 const OMISSION_NOTICE = `Content omitted: over the ${formatSize(MAX_FILE_BYTES)} limit.`;
-const TOO_LARGE_NOTICE = `History too large to print (over the ${formatSize(MAX_OUTPUT_BYTES)} budget). Read the relevant files among the entries above, skipping the plans (\`*-plan.md\`, \`*-main-plan.md\`, \`*-plan-*.md\`): their \`.summary.md\` files cover them.`;
+const TOO_LARGE_NOTICE = `History too large to print (over the ${formatSize(MAX_OUTPUT_BYTES)} budget). Read the relevant files among the entries above, skipping the plans (\`*-plan.md\`, \`*-main-plan.md\`, \`*-plan-*.md\`): the specs and \`.summary.md\` files provide the catch-up context.`;
 export function renderCatchup(cwd, ticket, report) {
     const files = ticket.entries.flatMap((entry) => catchupFile(cwd, ticket.dir, entry));
     if (files.length === 0)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alignfirst",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "license": "CC0-1.0",
   "author": "Thomas MUR",
   "description": "The AlignFirst CLI: protocols, work files and docs in one command.",
@@ -12,6 +12,7 @@
     "plans",
     "docmap"
   ],
+  "homepage": "https://alignfirst.paroi.tech/skills",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/paleo/alignfirst.git",
@@ -34,7 +35,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@paleo/docmap": "~0.10.0",
+    "@alignfirst/docmap": "~0.11.0",
     "arktype": "^2.2.3",
     "semver": "^7.8.5"
   },

package/templates/context/protocols.md

@@ -1,5 +1,17 @@
 # AlignFirst Protocols
 
-`{{CMD}} guide <protocol>` prints a collaborative protocol to follow when the user names AlignFirst or a protocol alias. A guide already in context is not reloaded. Each named guide includes the ticket directory and work file rules; `--protocol-only` omits them when they are already in context.
+When the user names AlignFirst with one of these protocols, or uses a protocol alias, run `{{CMD}} guide <protocol>` and follow it. Do not reload a guide already in context. Each guide includes the ticket directory and work file rules; use `--protocol-only` when those rules are already in context.
 
-Aliases: `alspec` → `spec`, `alplan` → `plan`, `al` or `AAD` → `aad`, `almerge` → `merge`, `alreview` → `review`, `aldescription` → `description`. `alcatchup` stands for `{{CMD}} ticket --catchup` followed by the user's instructions; `alcatchupaad` and `alcatchupspec` run it before the `aad` or `spec` protocol.
+Protocols and aliases:
+
+- `spec` (`alspec`)
+- `plan` (`alplan`)
+- `aad` (`AAD`, `al`)
+- `merge` (`almerge`)
+- `review` (`alreview`)
+- `description` (`aldescription`)
+
+Catch-up workflows and aliases:
+
+- Catch up (`alcatchup`) — run `{{CMD}} ticket --catchup`.
+- Catch up, then `aad` (`alcatchupaad`) or `spec` (`alcatchupspec`) — run `{{CMD}} ticket --catchup`, then follow the selected protocol.