@multileaf/ai-workflow 0.6.0 → 0.6.1

package/CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to this project are documented in this file. The format foll
 
 ## [Unreleased]
 
+## [0.6.1] - 2026-10-13
+
+### Added
+
+- Root context rendering: syncing a non-empty resource selection now writes the generated project context to the active target's root file (`AGENTS.md` for Codex/Cursor, `CLAUDE.md` for Claude Code, `GEMINI.md` for Gemini CLI), and `aiw target` migrates it between targets. The file is owned by AI Workflow, listed in the sync preview, and an existing hand-written root context is reported as a conflict instead of being overwritten.
+- Decision-model usage in `aiw recommend` is now recorded in `.aiw/usage.yml` (`recommend.decision`) alongside the scan stages.
+
+### Changed
+
+- Release workflows require a single protected-environment approval: the `github-release` job no longer declares the `npm` environment it did not need.
+
+### Added
+
+- Root context rendering: syncing a non-empty resource selection now writes the generated project context to the active target's root file (`AGENTS.md` for Codex/Cursor, `CLAUDE.md` for Claude Code, `GEMINI.md` for Gemini CLI), and `aiw target` migrates it between targets. The file is owned by AI Workflow, listed in the sync preview, and an existing hand-written root context is reported as a conflict instead of being overwritten.
+
 ## [0.6.0] - 2026-10-13
 
 ### Added
@@ -17,6 +32,7 @@ All notable changes to this project are documented in this file. The format foll
 
 - Interactive onboarding messages shortened to single-line prompts.
 - Embedding-model classification during onboarding now requires positive evidence (model name contains "embed" or Ollama family "embedding"); the previous heuristic misclassified `gpt-oss:20b` as an embedding model.
+
 ## [0.5.0] - 2026-10-08
 
 ### Added
@@ -33,6 +49,7 @@ All notable changes to this project are documented in this file. The format foll
 ### Changed
 
 - GitHub Actions now use Node 24-native `actions/checkout@v5` and `actions/setup-node@v5`, and CI runs on Node 24.
+
 ## [0.4.1] - 2026-10-08
 
 ### Fixed

package/README.md

@@ -63,7 +63,7 @@ For a Codex installation, the base layout is:
 
 `.aiw/` stores the provider-neutral manifest, profile, lockfile, checkpoints, bootstrap skill, selected resources, and generated working artifacts. ADRs are stored under `.context/adrs/`. The installer intentionally adds only `ai-init` and the base project state.
 
-Run `/ai-init` in the selected coding agent to scan the project and review evidence-based recommendations for skills, rules, agents, hooks, and templates. AI Workflow installs only the resources the user selects, then generates project-specific quality guidance from the detected stack and tools. Existing user files are preserved; conflicts are reported instead of overwritten. Hook resources are rendered according to each adapter's native or compatibility support.
+Run `/ai-init` in the selected coding agent to scan the project and review evidence-based recommendations for skills, rules, agents, hooks, and templates. AI Workflow installs only the resources the user selects, then generates project-specific quality guidance from the detected stack and tools. Syncing a non-empty selection also renders a root context file for the active target — `AGENTS.md` (Codex/Cursor), `CLAUDE.md` (Claude Code), `GEMINI.md` (Gemini CLI) — with the confirmed profile, quality commands, and pointers to `.aiw/` state; `aiw target` migrates it between targets. An existing hand-written root context file is reported as a conflict and never overwritten. Existing user files are preserved; conflicts are reported instead of overwritten. Hook resources are rendered according to each adapter's native or compatibility support.
 
 The installer does not modify `.gitignore`. Add `.aiw/generated/` yourself if generated specifications, plans, and artifacts should remain local. Versioned files under `.aiw/checkpoints/` are designed to remain reviewable project history.
 

package/dist/generator.js

@@ -23,6 +23,7 @@ export function generateProjectResources(profile, selected, write) {
         write(resolveGeneratedPath("agents/project-context.md"), `# Project Context\n\nThis project uses ${profile.frameworks.map((framework) => (framework === "nextjs" ? "Next.js" : framework)).join(", ")}. Follow the detected project structure and existing framework conventions.\n`);
     if (selected.length > 0) {
         write(resolveGeneratedPath("context/project-profile.md"), `# Confirmed Project Profile\n\n- Languages: ${profile.runtime.languages.join(", ") || "none detected"}\n- Frameworks: ${profile.frameworks.join(", ") || "none detected"}\n- Package manager: ${profile.packageManager}\n- All generated content is in English.\n`);
+        write(resolveGeneratedPath("context/root-context.md"), `# AI Workflow Project Context\n\nThis repository is managed by AI Workflow (\`.aiw/\` holds the neutral project state).\n\n- Languages: ${profile.runtime.languages.join(", ") || "none detected"}\n- Frameworks: ${profile.frameworks.join(", ") || "none detected"}\n- Package manager: ${profile.packageManager}${linterCommand ? `\n- Lint: \`${linterCommand}\`` : ""}${formatterCommand ? `\n- Format: \`${formatterCommand}\`` : ""}${uniqueTestCommands.map(({ scope, command }) => `\n- Tests (${scope}): \`${command}\``).join("")}\n\nBefore completing changes, run the project quality commands listed above. Follow installed AI Workflow skills, rules, and agents; the confirmed profile lives in \`.aiw/profile.yml\` and workflow evidence in \`.aiw/checkpoints/\`.\n`);
         write(resolveGeneratedPath("hooks/quality-check.md"), `# Quality Check Hook\n\nRun the available project quality commands before completion.${linterCommand ? `\n\n- Linter: \`${linterCommand}\`` : ""}${formatterCommand ? `\n- Formatter: \`${formatterCommand}\`` : ""}${uniqueTestCommands.map(({ scope, command }) => `\n- ${scope} tests: \`${command}\``).join("")}\n`);
     }
 }

package/dist/migration.d.ts

@@ -3,7 +3,7 @@ import type { Target } from "./types.js";
 export type ResourceMigration = {
     source: string;
     destination: string;
-    type: ResourceType;
+    type: ResourceType | "context";
     id: string;
     neutralSource: boolean;
 };

package/dist/migration.js

@@ -2,6 +2,7 @@ import { parseDocument } from "yaml";
 import { isAbsolute, join } from "node:path";
 import { renderResourcePath } from "./adapter.js";
 import { RESOURCE_TYPES } from "./package-contract.js";
+const MIGRATABLE_TYPES = [...RESOURCE_TYPES, "context"];
 export function planNeutralResourceMigration(neutralRoot, relativeFiles, target) {
     const migrations = [];
     const diagnostics = [];
@@ -14,9 +15,7 @@ export function planNeutralResourceMigration(neutralRoot, relativeFiles, target)
             diagnostics.push({ path: relative, reason: "path is not normalized and project-relative" });
             continue;
         }
-        if (extra ||
-            parts.length !== 3 ||
-            !RESOURCE_TYPES.includes(candidateType)) {
+        if (extra || parts.length !== 3 || !MIGRATABLE_TYPES.includes(candidateType)) {
             diagnostics.push({ path: relative, reason: "unsupported neutral resource path" });
             continue;
         }
@@ -39,7 +38,9 @@ export function planNeutralResourceMigration(neutralRoot, relativeFiles, target)
         }
         migrations.push({
             source: join(neutralRoot, relative),
-            destination: renderResourcePath(target, type, id),
+            destination: type === "context"
+                ? renderResourcePath(target, type, id)
+                : renderResourcePath(target, type, id),
             type,
             id,
             neutralSource: target === "universal",

package/dist/ownership.d.ts

@@ -5,7 +5,7 @@ export type OwnedFile = {
     checksum: string;
     kind?: "neutral-resource" | "target-resource" | "ai-init" | "supporting-file";
     target?: Target;
-    resourceType?: ResourceType;
+    resourceType?: ResourceType | "context";
     resourceId?: string;
 };
 export type OwnershipMetadata = Omit<OwnedFile, "path" | "checksum">;

package/dist/ownership.js

@@ -49,7 +49,7 @@ export function parseOwnership(content) {
         if (file.target !== undefined && !TARGETS.includes(file.target))
             throw new Error(`Ownership inventory target is invalid: ${file.path}`);
         if (file.resourceType !== undefined &&
-            !RESOURCE_TYPES.includes(String(file.resourceType)))
+            ![...RESOURCE_TYPES, "context"].includes(String(file.resourceType)))
             throw new Error(`Ownership inventory resource type is invalid: ${file.path}`);
         if (file.resourceId !== undefined &&
             (typeof file.resourceId !== "string" || !/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(file.resourceId)))

package/dist/workflow.js

@@ -1,7 +1,7 @@
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { randomUUID } from "node:crypto";
 import { BASE_DIRECTORIES, WORKFLOW_DIRECTORY } from "./constants.js";
-import { detectTarget, isTarget, renderAiInit, renderAiInitPath, renderResourcePath, } from "./adapter.js";
+import { detectTarget, isTarget, renderAiInit, describeResource, renderAiInitPath, renderResourcePath, } from "./adapter.js";
 import { loadBundledResources } from "./bundled-resources.js";
 import { assertSafeProjectPath, withSafeProjectWrites, writeProjectFilesAtomically, } from "./files.js";
 import { parseProjectProfile, profileProject } from "./profile.js";
@@ -1050,8 +1050,13 @@ export async function runCommand(args, root, fs, services = {}) {
                         exitCode: 1,
                         error: `Decision model ${rankingConfig.model} is not available at ${rankingConfig.baseUrl}.`,
                     };
+                let decisionTokens = 0;
                 ranked = await rankRecommendations(recommendations, profile, async (scoped, recs) => {
-                    const response = await decisionProvider.decide(buildRecommendationRankingRequest(profileSummaryForRanking(scoped), recs));
+                    const request = buildRecommendationRankingRequest(profileSummaryForRanking(scoped), recs);
+                    decisionTokens += Math.ceil((request.state.length +
+                        Object.values(request.questions).reduce((total, question) => total + question.instructions.length, 0)) /
+                        4);
+                    const response = await decisionProvider.decide(request);
                     const answers = {};
                     for (const [id, answer] of Object.entries(response.answers))
                         answers[id] =
@@ -1065,6 +1070,13 @@ export async function runCommand(args, root, fs, services = {}) {
                                 : {};
                     return answers;
                 });
+                const usagePath = join(aiw, "usage.yml");
+                const entries = fs.exists(usagePath) ? parseTokenUsage(fs.read(usagePath)) : [];
+                fs.write(usagePath, serializeTokenUsage(recordTokenUsage(entries, {
+                    stage: "recommend.decision",
+                    budget: decisionTokens,
+                    used: decisionTokens,
+                })));
                 ordered = ranked.items;
             }
             const selectedOption = args.find((arg) => arg.startsWith("--select="));
@@ -2134,6 +2146,25 @@ function syncSelectedResources(fs, root, aiw, profile, selected, apply = false,
         const rule = path.match(/^generated\/rules\/(project-quality|tdd-project-policy)\.md$/);
         if (rule)
             addResource("rules", rule[1], content);
+        const rootContext = path === "generated/context/root-context.md";
+        if (rootContext) {
+            const neutralContextPath = join(root, describeResource("universal", "context", "project").path);
+            addOwned(neutralContextPath, content, {
+                kind: "neutral-resource",
+                target: "universal",
+                resourceType: "context",
+                resourceId: "project",
+            });
+            const targetContextPath = describeResource(target, "context", "project").path;
+            if (targetContextPath !== renderAiInitPath(target)) {
+                addOwned(join(root, targetContextPath), content, {
+                    kind: "target-resource",
+                    target,
+                    resourceType: "context",
+                    resourceId: "project",
+                });
+            }
+        }
     });
     const ownershipPath = join(aiw, "ownership.yml");
     if (fs.pathType?.(ownershipPath) !== "file")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multileaf/ai-workflow",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Portable spec-driven development workflow for AI coding agents",
   "license": "MIT",
   "repository": {