@jaimevalasek/aioson 1.9.1 → 1.9.3

package/CHANGELOG.md

@@ -33,6 +33,24 @@ All notable changes to this project will be documented in this file.
 - Safe canonical English agent sources restored after i18n decoupling.
 - Accidentally tracked local directories removed from git tracking.
 
+## [1.9.3] - 2026-05-19
+
+### Fixed
+- **`@pm` agent prompt in template** now correctly declares ownership of `implementation-plan-{slug}.md` for MEDIUM features (AC-SDLC-15), completing the SDLC migration started in v1.9.0 (commit `981a8fd`). Projects on 1.9.0/1/2 hit a deadlock at Gate C when running MEDIUM features via the standard chain: `/architect` routed users to `/pm`, but the legacy template prompt instructed `/pm` to NOT silently create the artifact. The workspace prompt had been updated in `981a8fd` but the template, alignment test, and a docs file were never propagated.
+- **`tests/agent-runtime-alignment.test.js`** updated to assert the new canonical tokens (`## MEDIUM implementation plan (mandatory output for MEDIUM)`, `For MEDIUM features, @pm MUST produce implementation-plan-{slug}.md`, `## Non-MEDIUM handoff reality`, gate-approve command). The previous assertions were guarding the pre-`981a8fd` contract.
+- **`template/.aioson/agents/manifests/pm.manifest.json`** `capabilities[0].outputs[]` now declares `.aioson/context/implementation-plan-{slug}.md` as a canonical produce of `@pm`. Test alignment also asserts this. Source manifest synced for parity.
+- **`template/.aioson/skills/process/aioson-spec-driven/references/artifact-map.md`** ownership table corrected: `implementation-plan-{slug}.md` written by `@pm` for MEDIUM (AC-SDLC-15) instead of `@dev`, and read by `@dev, @deyvin, @orchestrator`. Also corrected the chain description (line 14).
+- **`template/.aioson/agents/orchestrator.md`** propagated from workspace — uses feature-scoped artifact naming (`requirements-{slug}.md`, `spec-{slug}.md`, `implementation-plan-{slug}.md`, `ui-spec-{slug}.md`) matching the post-`981a8fd` contract. Previously template still used legacy generic names.
+
+### Notes
+- **Rollback:** `npm install @jaimevalasek/aioson@1.9.2` (or pin in your project's `package.json`) restores the previous behavior. Use only as last resort — the previous state had `@pm` deadlock at Gate C for MEDIUM features.
+- **Affected:** any project installed from 1.9.0/1/2 running MEDIUM features through the standard chain (`/product → /analyst → /architect → /pm`).
+- **How to verify the fix in your project:** after `aioson update`, run a MEDIUM feature through the chain. `/pm` should produce `implementation-plan-{slug}.md` without refusing. `aioson workflow:status` should advance through Gate C.
+- **Follow-ups intentionally NOT included in this hotfix** (will be in a separate MEDIUM PRD, `prd-workflow-handoff-integrity.md`):
+  - `briefing.md` / `discover.md` template drift (one-line addition about `done/MANIFEST.md` awareness — benign but not tied to a documented plan).
+  - F1 (stale `dev-state.md` cleanup), F2 (workflow pointer auto-emission), F3 (analyst routing checks), T5 (CI guard for semantic drift), T6 (smoke test pre-publish).
+- **Audit trail for this hotfix:** see PR description, briefing `.aioson/briefings/workflow-handoff-integrity-1-9-2/briefings.md`, PRD `.aioson/context/prd-workflow-hotfix-1-9-3.md`.
+
 ## [1.7.3] - 2026-04-13
 ### Fixed
 - `@dev` pt-BR locale pack realigned with the canonical prompt flow, restoring the proper cold-start fallback when `dev-state.md` is already `done` and another feature is still `in_progress` in `features.md`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaimevalasek/aioson",
-  "version": "1.9.1",
+  "version": "1.9.3",
   "description": "AI operating framework for hyper-personalized software.",
   "keywords": [
     "ai",

package/src/commands/update.js

@@ -10,12 +10,14 @@ async function runUpdate({ args, options, logger, t }) {
   const targetDir = path.resolve(process.cwd(), args[0] || '.');
   const dryRun = Boolean(options['dry-run']);
   const all = Boolean(options.all);
+  const selective = Boolean(options.selective);
   const requestedLanguage = options.lang || options.language;
 
   const detection = await detectFramework(targetDir);
   const result = await updateInstallation(targetDir, {
     dryRun,
     all,
+    selective,
     frameworkDetection: detection.framework
   });
 

package/src/gateway-pointer-merge.js

@@ -14,6 +14,7 @@ const { exists, copyFileWithDir, toRelativeSafe } = require('./utils');
 
 const MARKER_BEGIN = '<!-- AIOSON:BEGIN -->';
 const MARKER_END = '<!-- AIOSON:END -->';
+const BLOCK_NOTICE = '> Managed by AIOSON — edits inside this block will be overwritten on `aioson update`. Put project-specific rules above or below this block.';
 
 const GATEWAY_POINTER_FILES = new Set([
   'CLAUDE.md',
@@ -28,7 +29,7 @@ function isGatewayPointerPath(rel) {
 
 function buildBlock(templateContent) {
   const body = templateContent.endsWith('\n') ? templateContent : `${templateContent}\n`;
-  return `${MARKER_BEGIN}\n${body}${MARKER_END}\n`;
+  return `${MARKER_BEGIN}\n${BLOCK_NOTICE}\n\n${body}${MARKER_END}\n`;
 }
 
 function findBlockRange(content) {
@@ -93,6 +94,7 @@ async function mergeGatewayPointer({ templatePath, targetPath, backupRoot, targe
 module.exports = {
   MARKER_BEGIN,
   MARKER_END,
+  BLOCK_NOTICE,
   GATEWAY_POINTER_FILES,
   isGatewayPointerPath,
   buildBlock,

package/src/parser.js

@@ -30,6 +30,7 @@ function parseArgv(argv) {
         'help', 'version', 'no-launch', 'attach', 'tmux',
         'allow-warnings', 'install-hook', 'uninstall-hook', 'remove-hook',
         'agent-safe',
+        'selective',
         'status', 'suggest', 'apply',
         // `--resume` alone means "resume last"; `--resume=<id>` carries a value
         // and is handled by the `=` branch above. Without this entry, `--resume`

package/src/updater.js

@@ -16,8 +16,12 @@ async function updateInstallation(targetDir, options = {}) {
 
   const savedProfile = await readInstallProfile(targetDir);
 
-  // Default: only update files already present in the target (selective update).
-  // With --all: install every file from the template, including new ones not yet installed.
+  // Default: sync everything from the template, including files added by the
+  // release that aren't yet in the target. Pre-1.9.2 this defaulted to
+  // selective and silently dropped new agents/slash commands between versions.
+  // `--selective` restores the legacy conservative mode; `--all` is accepted
+  // as a backwards-compat no-op since "all" is now the default.
+  const selective = Boolean(options.selective) && !options.all;
   const result = await installTemplate(targetDir, {
     overwrite: true,
     dryRun: Boolean(options.dryRun),
@@ -25,7 +29,7 @@ async function updateInstallation(targetDir, options = {}) {
     backupOnOverwrite: true,
     frameworkDetection: options.frameworkDetection || null,
     installProfile: savedProfile,
-    selectiveUpdate: !options.all
+    selectiveUpdate: selective
   });
 
   // Post-install migrations. Best-effort: a migration failure must not break

package/template/.aioson/agents/manifests/pm.manifest.json

@@ -15,7 +15,8 @@
       ],
       "outputs": [
         { "type": "artifact", "path_pattern": ".aioson/context/prd.md" },
-        { "type": "artifact", "path_pattern": ".aioson/context/prd-{slug}.md" }
+        { "type": "artifact", "path_pattern": ".aioson/context/prd-{slug}.md" },
+        { "type": "artifact", "path_pattern": ".aioson/context/implementation-plan-{slug}.md" }
       ]
     }
   ],

package/template/.aioson/agents/orchestrator.md

@@ -8,11 +8,12 @@ Orchestrate parallel execution only for MEDIUM projects. Never activate for MICR
 
 ## Required input
 - `.aioson/context/project.context.md`
-- `.aioson/context/discovery.md`
+- `.aioson/context/requirements-{slug}.md` — read the full body, not only frontmatter (Gate A artifact; defines what each lane must implement)
+- `.aioson/context/spec-{slug}.md` — read the full body (living feature memory; has gate status, decisions, and lane context)
 - `.aioson/context/architecture.md`
 - `.aioson/context/prd.md` or `prd-{slug}.md`
-- `.aioson/context/ui-spec.md` when present
-- `.aioson/context/implementation-plan.md` or `implementation-plan-{slug}.md` when present
+- `.aioson/context/implementation-plan-{slug}.md` when present (Gate C; defines execution phases for lane assignment)
+- `.aioson/context/ui-spec-{slug}.md` when present
 - `.aioson/context/parallel/` when resuming an existing orchestration session
 
 ## Skills and docs on demand

package/template/.aioson/agents/pm.md

@@ -26,8 +26,9 @@ Loaded rules, design docs, and design governance override the default convention
 Maximum 2 pages. If it exceeds that, you are doing more than necessary. Cut ruthlessly.
 
 ## When to use
-- **MEDIUM** projects: required, runs after `@architect` and `@ux-ui`.
-- **MICRO** projects: skip — `@dev` reads context and architecture directly.
+- **MEDIUM** projects: required, runs after `@architect` and `@ux-ui`. `@pm` is the canonical owner of the initial `implementation-plan-{slug}.md`.
+- **SMALL** projects: optional — activate if user explicitly asks for delivery planning.
+- **MICRO** projects: skip — `@dev` reads context and architecture directly. Do not produce an implementation plan for MICRO.
 
 ## Required input
 - `.aioson/context/project.context.md`
@@ -68,11 +69,62 @@ For existing codebases:
 - `discovery.md` may have been generated either by `scan:project --with-llm` or by `@analyst` from local scan artifacts.
 - If `discovery.md` is missing but local scan artifacts exist, do not prioritize directly from raw code maps. Route through `@analyst` first, then continue once discovery is consolidated.
 
-## Handoff reality
+## MEDIUM implementation plan (mandatory output for MEDIUM)
 
-- The canonical `@pm` workflow stage enriches the existing PRD in place.
-- Do not silently create `implementation-plan.md` or `implementation-plan-{slug}.md` as if they were mandatory outputs of this stage.
-- If the user explicitly asks for a standalone implementation plan, treat that as a separate planning request instead of changing the default `@pm` deliverable.
+For MEDIUM features, `@pm` MUST produce `implementation-plan-{slug}.md` in `.aioson/context/`. This is Gate C.
+
+Structure:
+```markdown
+---
+feature: {slug}
+status: approved
+created_by: pm
+created_at: {ISO date}
+classification: MEDIUM
+gate: C
+gate_status: approved
+---
+
+# Implementation Plan — {Feature Name}
+
+## Gate C Summary
+[Why Gate C is approved — prerequisites satisfied]
+
+## Required Context Package
+[Ordered list of files @dev must read]
+
+## Pre-Taken Decisions
+[Decisions already made — @dev does not re-discuss these]
+
+## Execution Sequence
+| Phase | Scope | Primary files | Done criteria |
+|---|---|---|---|
+| 1 | ... | ... | ... |
+
+## Checkpoints
+[After each phase, what @dev must update]
+```
+
+After writing the plan, always close Gate C:
+```
+aioson gate:approve . --feature={slug} --gate=C
+```
+Or manually set `gate_plan: approved` in `spec-{slug}.md`.
+
+**Handoff:**
+```
+Implementation plan written: .aioson/context/implementation-plan-{slug}.md
+Gate C: approved
+Next agent: @orchestrator (MEDIUM) or @dev (SMALL, user confirmed)
+Action: /orchestrator or /dev
+```
+
+## Non-MEDIUM handoff reality
+
+For non-MEDIUM projects or when the user activates `@pm` for enrichment only:
+- Enrich the existing PRD in place.
+- Do not produce `implementation-plan-{slug}.md` unless explicitly requested.
+- If the feature is MEDIUM and missing a plan, inform the user and offer to produce it.
 
 ## Output contract
 Update the same PRD file you read (`prd.md` or `prd-{slug}.md`) in place. Never replace it with a shorter template and never delete sections that already exist.

package/template/.aioson/skills/process/aioson-spec-driven/references/artifact-map.md

@@ -11,7 +11,7 @@ prd*.md
   → spec-{slug}.md                 (feature memory — @analyst seeds, @dev fills)
   → architecture.md                (tech decisions — @architect)
   → design-doc*.md                 (scope-specific decisions — @architect)
-  → implementation-plan-{slug}.md  (execution sequence — @dev)
+  → implementation-plan-{slug}.md  (execution sequence — @pm for MEDIUM, AC-SDLC-15)
   → spec-{slug}.md (updated)       (living state during execution — @dev)
 ```
 
@@ -28,7 +28,7 @@ prd*.md
 | `spec.md` | @dev | @dev | @dev, @deyvin |
 | `architecture.md` | @architect | — | @dev, @ux-ui |
 | `design-doc*.md` | @architect | — | @dev, @ux-ui |
-| `implementation-plan-{slug}.md` | @dev | — | @dev, @deyvin |
+| `implementation-plan-{slug}.md` | @pm (MEDIUM, AC-SDLC-15) | — | @dev, @deyvin, @orchestrator |
 
 ## Naming conventions