@open-agent-toolkit/cli 0.2.51 → 0.2.53

package/dist/commands/init/tools/install-state.d.ts

@@ -1,3 +1,4 @@
+import type { ToolPackEvidence } from '../../tools/shared/pack-evidence.js';
 import type { PackInventory } from '../../tools/shared/pack-inventory.js';
 import type { PackName, ToolInfo } from '../../tools/shared/types.js';
 export type PackInstallLocation = 'not-installed' | 'project' | 'user' | 'both';
@@ -9,4 +10,5 @@ export interface PackInstallState {
 export declare function resolvePackInstallLocation(project: boolean, user: boolean): PackInstallLocation;
 export declare function buildPackInstallStateMap<TPack extends PackName>(packs: readonly TPack[], tools: ToolInfo[]): Record<TPack, PackInstallState>;
 export declare function buildPackInstallStateMapFromInventory<TPack extends PackName>(packs: readonly TPack[], inventories: readonly PackInventory[]): Record<TPack, PackInstallState>;
+export declare function buildPackInstallStateMapFromEvidence<TPack extends PackName>(packs: readonly TPack[], evidence: readonly ToolPackEvidence[]): Record<TPack, PackInstallState>;
 //# sourceMappingURL=install-state.d.ts.map

package/dist/commands/init/tools/install-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install-state.d.ts","sourceRoot":"","sources":["../../../../src/commands/init/tools/install-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAEvE,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,OAAO,GACZ,mBAAmB,CAcrB;AAED,wBAAgB,wBAAwB,CAAC,KAAK,SAAS,QAAQ,EAC7D,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,KAAK,EAAE,QAAQ,EAAE,GAChB,MAAM,CAAC,KAAK,EAAE,gBAAgB,CAAC,CA8BjC;AAED,wBAAgB,qCAAqC,CAAC,KAAK,SAAS,QAAQ,EAC1E,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,WAAW,EAAE,SAAS,aAAa,EAAE,GACpC,MAAM,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAgBjC"}
+{"version":3,"file":"install-state.d.ts","sourceRoot":"","sources":["../../../../src/commands/init/tools/install-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAEvE,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,OAAO,GACZ,mBAAmB,CAcrB;AAED,wBAAgB,wBAAwB,CAAC,KAAK,SAAS,QAAQ,EAC7D,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,KAAK,EAAE,QAAQ,EAAE,GAChB,MAAM,CAAC,KAAK,EAAE,gBAAgB,CAAC,CA8BjC;AAED,wBAAgB,qCAAqC,CAAC,KAAK,SAAS,QAAQ,EAC1E,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,WAAW,EAAE,SAAS,aAAa,EAAE,GACpC,MAAM,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAgBjC;AAED,wBAAgB,oCAAoC,CAAC,KAAK,SAAS,QAAQ,EACzE,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,QAAQ,EAAE,SAAS,gBAAgB,EAAE,GACpC,MAAM,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAejC"}

package/dist/commands/init/tools/install-state.js

@@ -45,3 +45,14 @@ export function buildPackInstallStateMapFromInventory(packs, inventories) {
         ];
     }));
 }
+export function buildPackInstallStateMapFromEvidence(packs, evidence) {
+    return Object.fromEntries(packs.map((pack) => {
+        const packEvidence = evidence.find((candidate) => candidate.pack === pack);
+        const project = packEvidence?.knownRealizedScopes.includes('project') ?? false;
+        const user = packEvidence?.knownRealizedScopes.includes('user') ?? false;
+        return [
+            pack,
+            { project, user, location: resolvePackInstallLocation(project, user) },
+        ];
+    }));
+}

package/dist/commands/init/tools/project-guidance.d.ts

@@ -0,0 +1,49 @@
+import type { AgentsMdManualPatch } from '../../shared/agents-md.js';
+import type { PromptContext } from '../../shared/shared.prompts.js';
+import type { PackName } from '../../tools/shared/types.js';
+import type { Command } from 'commander';
+export type ProjectGuidanceChoice = {
+    choice: 'accepted';
+    source: 'prompt' | 'flag';
+} | {
+    choice: 'declined';
+    source: 'prompt' | 'flag';
+} | {
+    choice: 'not-requested';
+    source: 'non-interactive-default';
+};
+export type AgentsGuidanceAction = 'declined' | 'not-requested' | 'create' | 'no-change' | 'manual-required' | 'blocked';
+export interface ProjectGuidancePack {
+    pack: PackName;
+    scope: 'project' | 'user' | 'both';
+}
+export interface AgentsGuidancePlan {
+    repoRoot: string | null;
+    target: string | null;
+    action: AgentsGuidanceAction;
+    sectionKey: 'tools';
+    body: string;
+    legacySectionAction: 'preserve' | 'remove';
+    reason: string;
+    choice: ProjectGuidanceChoice;
+    manualPatch?: AgentsMdManualPatch;
+}
+export interface PlanProjectGuidanceInput {
+    repoRoot: string | null;
+    packs: readonly ProjectGuidancePack[];
+    explicitChoice?: boolean;
+    interactive: boolean;
+    confirmAction: (message: string, context: PromptContext) => Promise<boolean>;
+}
+export declare function reportableProjectGuidance(plan: AgentsGuidancePlan): {
+    action: AgentsGuidanceAction;
+    choice: ProjectGuidanceChoice;
+    reason: string;
+    manualPatch?: AgentsMdManualPatch | undefined;
+};
+export declare function buildToolPacksSectionBody(packs: readonly ProjectGuidancePack[]): string;
+export declare function parseProjectGuidanceFlags(args: readonly string[]): boolean | undefined;
+export declare function commandProjectGuidanceChoice(command: Command): boolean | undefined;
+export declare function withProjectGuidanceOptions<TCommand extends Command>(command: TCommand): TCommand;
+export declare function planProjectGuidance(input: PlanProjectGuidanceInput): Promise<AgentsGuidancePlan>;
+//# sourceMappingURL=project-guidance.d.ts.map

package/dist/commands/init/tools/project-guidance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-guidance.d.ts","sourceRoot":"","sources":["../../../../src/commands/init/tools/project-guidance.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,MAAM,qBAAqB,GAC7B;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAA;CAAE,GACjD;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAA;CAAE,GACjD;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,yBAAyB,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,oBAAoB,GAC5B,UAAU,GACV,eAAe,GACf,QAAQ,GACR,WAAW,GACX,iBAAiB,GACjB,SAAS,CAAC;AAEd,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,qBAAqB,CAAC;IAC9B,WAAW,CAAC,EAAE,mBAAmB,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACtC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9E;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,kBAAkB;;;;;EAOjE;AAgBD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,mBAAmB,EAAE,GACpC,MAAM,CA2CR;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,OAAO,GAAG,SAAS,CAYrB;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,OAAO,GACf,OAAO,GAAG,SAAS,CAKrB;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,SAAS,OAAO,EACjE,OAAO,EAAE,QAAQ,GAChB,QAAQ,CAcV;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAyE7B"}

package/dist/commands/init/tools/project-guidance.js

@@ -0,0 +1,144 @@
+import { join } from 'node:path';
+import { CliError } from '../../../errors/index.js';
+export function reportableProjectGuidance(plan) {
+    return {
+        action: plan.action,
+        choice: plan.choice,
+        reason: plan.reason,
+        ...(plan.manualPatch ? { manualPatch: plan.manualPatch } : {}),
+    };
+}
+const PACK_DESCRIPTIONS = {
+    core: 'Diagnostics and documentation (oat-doctor, oat-docs)',
+    docs: 'Documentation and instruction governance workflows',
+    workflows: 'Project lifecycle (create, discover, plan, implement, review, complete)',
+    ideas: 'Idea capture and refinement',
+    'project-management': 'Local backlog, roadmap, and reference doc management (oat-pjm-* skills)',
+    utility: 'Standalone utilities (skill authoring, maintainability review, code reviews)',
+    research: 'Research, analysis, verification, and synthesis',
+    brainstorm: 'Always-on brainstorming entry point with visual companion',
+};
+export function buildToolPacksSectionBody(packs) {
+    const userPacks = packs.filter((pack) => pack.scope === 'user' || pack.scope === 'both');
+    const hasWorkflows = packs.some((pack) => pack.pack === 'workflows');
+    const lines = [
+        '## Tool Packs',
+        '',
+        '- **Skills directory:** `.agents/skills/`',
+        '- **Discover available skills:** scan `.agents/skills/*/SKILL.md`',
+        '- **Refresh provider views:** `oat sync --scope all`',
+        '- **Update skills to latest versions:** `oat tools update`',
+    ];
+    if (userPacks.length > 0) {
+        lines.push(`- **User-scoped skills:** \`~/.agents/skills/\` (${userPacks.map(({ pack }) => pack).join(', ')} packs installed at user scope)`);
+    }
+    lines.push('', '### Installed Packs', '');
+    for (const { pack, scope } of packs) {
+        const suffix = scope === 'user'
+            ? ' _(user scope)_'
+            : scope === 'both'
+                ? ' _(project + user scope)_'
+                : '';
+        lines.push(`- **${pack}** — ${PACK_DESCRIPTIONS[pack]}${suffix}`);
+    }
+    if (hasWorkflows) {
+        lines.push('', '### Workflow Execution Continuation', '', '- This guidance applies only to OAT project lifecycle execution, such as `oat-project-implement`, and OAT project review/receive flows. It does not apply to non-OAT tasks or ad-hoc work outside the OAT project workflow.', '- When executing an OAT project implementation or OAT project review workflow, do not stop at task boundaries, phase boundaries, or other clean checkpoints unless the configured HiLL checkpoint has been reached, a real blocker exists, or explicit user input is required.', '- Status summaries, completed bookkeeping, and "clean boundary" pauses are not valid stop reasons. After updating tracking artifacts, continue execution until an allowed stop condition applies.');
+    }
+    return lines.join('\n');
+}
+export function parseProjectGuidanceFlags(args) {
+    const accepted = args.includes('--project-guidance');
+    const declined = args.includes('--no-project-guidance');
+    if (accepted && declined) {
+        throw new CliError('--project-guidance and --no-project-guidance cannot be used together.', 1);
+    }
+    if (accepted)
+        return true;
+    if (declined)
+        return false;
+    return undefined;
+}
+export function commandProjectGuidanceChoice(command) {
+    let root = command;
+    while (root.parent)
+        root = root.parent;
+    const rawArgs = root.rawArgs;
+    return parseProjectGuidanceFlags(rawArgs ?? process.argv.slice(2));
+}
+export function withProjectGuidanceOptions(command) {
+    if (!command.options.some(({ long }) => long === '--project-guidance')) {
+        command.option('--project-guidance', 'Create missing or print manual repository AGENTS.md tool guidance');
+    }
+    if (!command.options.some(({ long }) => long === '--no-project-guidance')) {
+        command.option('--no-project-guidance', 'Decline repository AGENTS.md tool guidance');
+    }
+    return command;
+}
+export async function planProjectGuidance(input) {
+    let choice;
+    if (input.explicitChoice === true) {
+        choice = { choice: 'accepted', source: 'flag' };
+    }
+    else if (input.explicitChoice === false) {
+        choice = { choice: 'declined', source: 'flag' };
+    }
+    else if (!input.interactive) {
+        choice = {
+            choice: 'not-requested',
+            source: 'non-interactive-default',
+        };
+    }
+    else {
+        const accepted = await input.confirmAction('Create missing or propose manual repository AGENTS.md tool guidance?', { interactive: input.interactive });
+        choice = accepted
+            ? { choice: 'accepted', source: 'prompt' }
+            : { choice: 'declined', source: 'prompt' };
+    }
+    const body = buildToolPacksSectionBody(input.packs);
+    if (choice.choice === 'declined') {
+        return {
+            repoRoot: input.repoRoot,
+            target: input.repoRoot ? join(input.repoRoot, 'AGENTS.md') : null,
+            action: 'declined',
+            sectionKey: 'tools',
+            body,
+            legacySectionAction: 'preserve',
+            reason: 'Project guidance was declined; capability placement is unchanged.',
+            choice,
+        };
+    }
+    if (choice.choice === 'not-requested') {
+        return {
+            repoRoot: input.repoRoot,
+            target: input.repoRoot ? join(input.repoRoot, 'AGENTS.md') : null,
+            action: 'not-requested',
+            sectionKey: 'tools',
+            body,
+            legacySectionAction: 'preserve',
+            reason: 'Project guidance was not requested. Re-run with --project-guidance to create an absent AGENTS.md or print a manual patch for an existing one.',
+            choice,
+        };
+    }
+    if (!input.repoRoot) {
+        return {
+            repoRoot: null,
+            target: null,
+            action: 'blocked',
+            sectionKey: 'tools',
+            body,
+            legacySectionAction: 'preserve',
+            reason: 'Project guidance requires a repository root; capability installation remains independent.',
+            choice,
+        };
+    }
+    return {
+        repoRoot: input.repoRoot,
+        target: join(input.repoRoot, 'AGENTS.md'),
+        action: 'create',
+        sectionKey: 'tools',
+        body,
+        legacySectionAction: 'remove',
+        reason: 'Project guidance was accepted. An absent AGENTS.md may be created; an existing file requires a manual patch.',
+        choice,
+    };
+}

package/dist/commands/init/tools/workflows/index.d.ts

@@ -1,6 +1,10 @@
 import { type CommandContext, type GlobalOptions } from '../../../../app/command-context.js';
+import { type AgentsMdMutationOptions, type UpsertSectionResult } from '../../../shared/agents-md.js';
 import { type PromptContext } from '../../../shared/shared.prompts.js';
+import type { ScanToolsOptions } from '../../../tools/shared/scan-tools.js';
+import type { ToolInfo } from '../../../tools/shared/types.js';
 import { Command } from 'commander';
+import { planProjectGuidance } from '../project-guidance.js';
 import { type InstallWorkflowsOptions, type InstallWorkflowsResult, type InstallWorkflowsScope } from './install-workflows.js';
 interface InitToolsWorkflowsDependencies {
     buildCommandContext: (options: GlobalOptions) => CommandContext;
@@ -9,6 +13,9 @@ interface InitToolsWorkflowsDependencies {
     resolveAssetsRoot: () => Promise<string>;
     installWorkflows: (options: InstallWorkflowsOptions) => Promise<InstallWorkflowsResult>;
     confirmAction: (message: string, ctx: PromptContext) => Promise<boolean>;
+    scanTools: (options: ScanToolsOptions) => Promise<ToolInfo[]>;
+    planProjectGuidance: typeof planProjectGuidance;
+    upsertAgentsMdSection: (repoRoot: string, key: string, body: string, options?: AgentsMdMutationOptions) => Promise<UpsertSectionResult>;
 }
 export declare function createInitToolsWorkflowsCommand(overrides?: Partial<InitToolsWorkflowsDependencies>): Command;
 export {};

package/dist/commands/init/tools/workflows/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/workflows/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,iCAAiC,CAAC;AASzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,qBAAqB,CAAC;AAM7B,UAAU,8BAA8B;IACtC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,gBAAgB,EAAE,CAChB,KAAK,EAAE,qBAAqB,EAC5B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,KACT,MAAM,CAAC;IACZ,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,gBAAgB,EAAE,CAChB,OAAO,EAAE,uBAAuB,KAC7B,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACrC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAsGD,wBAAgB,+BAA+B,CAC7C,SAAS,GAAE,OAAO,CAAC,8BAA8B,CAAM,GACtD,OAAO,CAsBT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/workflows/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EAIzB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,iCAAiC,CAAC;AAQzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAY,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAGvE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAGL,mBAAmB,EAIpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,qBAAqB,CAAC;AAM7B,UAAU,8BAA8B;IACtC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,gBAAgB,EAAE,CAChB,KAAK,EAAE,qBAAqB,EAC5B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,KACT,MAAM,CAAC;IACZ,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,gBAAgB,EAAE,CAChB,OAAO,EAAE,uBAAuB,KAC7B,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACrC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9D,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;IAChD,qBAAqB,EAAE,CACrB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,uBAAuB,KAC9B,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACnC;AA+SD,wBAAgB,+BAA+B,CAC7C,SAAS,GAAE,OAAO,CAAC,8BAA8B,CAAM,GACtD,OAAO,CAuBT"}

package/dist/commands/init/tools/workflows/index.js

@@ -1,12 +1,15 @@
 import { buildCommandContext, } from '../../../../app/command-context.js';
+import { formatAgentsMdGuidanceResult, formatAgentsMdMutationFailure, upsertAgentsMdSection, } from '../../../shared/agents-md.js';
 import { withScopeOption } from '../../../shared/scope-option.js';
 import { confirmAction, } from '../../../shared/shared.prompts.js';
 import { readGlobalOptions } from '../../../shared/shared.utils.js';
 import { canonicalPathsForPack, setInstalledCanonicalPaths, } from '../../../tools/shared/install-sync-context.js';
 import { getPackDefinition } from '../../../tools/shared/pack-manifest.js';
+import { scanTools } from '../../../tools/shared/scan-tools.js';
 import { resolveAssetsRoot } from '../../../../fs/assets.js';
 import { resolveProjectRoot, resolveScopeRoot } from '../../../../fs/paths.js';
 import { Command } from 'commander';
+import { commandProjectGuidanceChoice, planProjectGuidance, reportableProjectGuidance, withProjectGuidanceOptions, } from '../project-guidance.js';
 import { installWorkflows as defaultInstallWorkflows, } from './install-workflows.js';
 const DEFAULT_DEPENDENCIES = {
     buildCommandContext,
@@ -15,29 +18,174 @@ const DEFAULT_DEPENDENCIES = {
     resolveAssetsRoot,
     installWorkflows: defaultInstallWorkflows,
     confirmAction,
+    scanTools,
+    planProjectGuidance,
+    upsertAgentsMdSection,
 };
-function reportSuccess(context, scope, targetRoot, assetsRoot, result) {
+const ALL_TOOL_PACKS = [
+    'core',
+    'ideas',
+    'docs',
+    'workflows',
+    'utility',
+    'project-management',
+    'research',
+    'brainstorm',
+];
+function realizedProjectGuidancePacks(tools) {
+    return ALL_TOOL_PACKS.flatMap((pack) => {
+        const project = tools.some((tool) => tool.pack === pack && tool.scope === 'project');
+        const user = tools.some((tool) => tool.pack === pack && tool.scope === 'user');
+        if (!project && !user)
+            return [];
+        return [
+            {
+                pack,
+                scope: project && user ? 'both' : project ? 'project' : 'user',
+            },
+        ];
+    });
+}
+async function applyProjectGuidance(plan, dependencies) {
+    if (plan.action !== 'create' || !plan.repoRoot)
+        return plan;
+    try {
+        const result = await dependencies.upsertAgentsMdSection(plan.repoRoot, plan.sectionKey, plan.body, plan.legacySectionAction === 'remove'
+            ? { removeSectionKeys: ['workflows'] }
+            : undefined);
+        if (result.action === 'manual-required') {
+            return {
+                ...plan,
+                action: 'manual-required',
+                reason: 'Accepted project guidance requires the reported manual AGENTS.md patch. Capability placement and PJM adoption were unchanged.',
+                manualPatch: result.manualPatch,
+            };
+        }
+        if (result.action === 'blocked') {
+            return {
+                ...plan,
+                action: 'blocked',
+                reason: `Accepted project guidance was blocked: ${result.blocked?.reason ?? 'AGENTS.md could not be planned safely.'} ${result.blocked?.action ?? ''}`.trim(),
+            };
+        }
+        return {
+            ...plan,
+            action: result.action === 'created' ? 'create' : 'no-change',
+            reason: `Accepted project guidance ${result.action}. Capability placement and PJM adoption were unchanged.`,
+        };
+    }
+    catch (error) {
+        return {
+            ...plan,
+            action: 'blocked',
+            reason: `Accepted project guidance was blocked: ${formatAgentsMdMutationFailure(error)}`,
+        };
+    }
+}
+function reportSuccess(context, scope, targetRoot, assetsRoot, result, projectGuidance) {
     if (context.json) {
+        if (projectGuidance.action === 'blocked' ||
+            projectGuidance.action === 'manual-required') {
+            context.logger.json({
+                status: 'partial',
+                scope,
+                capability: {
+                    status: 'complete',
+                    skills: result.copiedSkills.length + result.updatedSkills.length,
+                    agents: result.copiedAgents.length + result.updatedAgents.length,
+                    templates: result.copiedTemplates.length + result.updatedTemplates.length,
+                    scripts: result.copiedScripts.length + result.updatedScripts.length,
+                },
+                projectGuidance: reportableProjectGuidance(projectGuidance),
+            });
+            return;
+        }
         context.logger.json({
             status: 'ok',
             scope,
             targetRoot,
             assetsRoot,
             result,
+            projectGuidance: reportableProjectGuidance(projectGuidance),
         });
         return;
     }
     context.logger.info('Installed workflows tool pack.');
     context.logger.info(`Scope: ${scope}`);
-    context.logger.info(`Target root: ${targetRoot}`);
+    if (projectGuidance.action !== 'blocked' &&
+        projectGuidance.action !== 'manual-required') {
+        context.logger.info(`Target root: ${targetRoot}`);
+    }
     context.logger.info(`Skills: copied=${result.copiedSkills.length}, updated=${result.updatedSkills.length}, skipped=${result.skippedSkills.length}`);
     context.logger.info(`Agents: copied=${result.copiedAgents.length}, updated=${result.updatedAgents.length}, skipped=${result.skippedAgents.length}`);
     context.logger.info(`Templates: copied=${result.copiedTemplates.length}, updated=${result.updatedTemplates.length}, skipped=${result.skippedTemplates.length}`);
     context.logger.info(`Scripts: copied=${result.copiedScripts.length}, updated=${result.updatedScripts.length}, skipped=${result.skippedScripts.length}`);
     context.logger.info(`Projects root initialized: ${result.projectsRootInitialized ? 'yes' : 'no'}`);
+    const guidanceMessage = `Project guidance: ${projectGuidance.action} — ${projectGuidance.reason}`;
+    if (projectGuidance.action === 'blocked' ||
+        projectGuidance.action === 'manual-required') {
+        context.logger.warn(guidanceMessage);
+        if (projectGuidance.manualPatch) {
+            for (const line of formatAgentsMdGuidanceResult({
+                action: 'manual-required',
+                manualPatch: projectGuidance.manualPatch,
+            })) {
+                context.logger.info(line);
+            }
+        }
+    }
+    else {
+        context.logger.info(guidanceMessage);
+    }
     context.logger.info(`Run: oat sync --scope ${scope}`);
 }
-async function runInitToolsWorkflows(context, options, dependencies) {
+async function planAndApplyProjectGuidance(context, scope, targetRoot, assetsRoot, explicitChoice, dependencies) {
+    const projectTarget = scope === 'project' ? targetRoot : null;
+    const initialPlan = await dependencies.planProjectGuidance({
+        repoRoot: projectTarget,
+        packs: [],
+        explicitChoice,
+        interactive: context.interactive,
+        confirmAction: dependencies.confirmAction,
+    });
+    if (initialPlan.choice.choice !== 'accepted')
+        return initialPlan;
+    try {
+        let repoRoot = projectTarget;
+        if (!repoRoot) {
+            repoRoot = await dependencies.resolveProjectRoot(context.cwd);
+        }
+        const userRoot = dependencies.resolveScopeRoot('user', context.cwd, context.home);
+        const [projectTools, userTools] = await Promise.all([
+            dependencies.scanTools({
+                scope: 'project',
+                scopeRoot: repoRoot,
+                assetsRoot,
+            }),
+            dependencies.scanTools({
+                scope: 'user',
+                scopeRoot: userRoot,
+                assetsRoot,
+            }),
+        ]);
+        const completePlan = await dependencies.planProjectGuidance({
+            repoRoot,
+            packs: realizedProjectGuidancePacks([...projectTools, ...userTools]),
+            explicitChoice: true,
+            interactive: false,
+            confirmAction: dependencies.confirmAction,
+        });
+        return applyProjectGuidance(completePlan, dependencies);
+    }
+    catch (error) {
+        return {
+            ...initialPlan,
+            action: 'blocked',
+            reason: `Accepted project guidance was blocked: ${formatAgentsMdMutationFailure(error)}`,
+        };
+    }
+}
+async function runInitToolsWorkflows(context, options, dependencies, explicitProjectGuidance) {
     try {
         const scope = context.scope === 'project' || context.scope === 'user'
             ? context.scope
@@ -62,8 +210,13 @@ async function runInitToolsWorkflows(context, options, dependencies) {
             scope,
             force: options.force,
         });
-        reportSuccess(context, scope, targetRoot, assetsRoot, result);
-        process.exitCode = 0;
+        const projectGuidance = await planAndApplyProjectGuidance(context, scope, targetRoot, assetsRoot, explicitProjectGuidance, dependencies);
+        reportSuccess(context, scope, targetRoot, assetsRoot, result, projectGuidance);
+        process.exitCode =
+            projectGuidance.action === 'blocked' ||
+                projectGuidance.action === 'manual-required'
+                ? 1
+                : 0;
         return true;
     }
     catch (error) {
@@ -83,12 +236,12 @@ export function createInitToolsWorkflowsCommand(overrides = {}) {
         ...DEFAULT_DEPENDENCIES,
         ...overrides,
     };
-    return withScopeOption(new Command('workflows'))
+    return withProjectGuidanceOptions(withScopeOption(new Command('workflows')))
         .description('Install OAT workflows skills, agents, templates, and scripts')
         .option('--force', 'Overwrite existing files where applicable')
         .action(async (options, command) => {
         const context = dependencies.buildCommandContext(readGlobalOptions(command));
-        const didInstall = await runInitToolsWorkflows(context, options, dependencies);
+        const didInstall = await runInitToolsWorkflows(context, options, dependencies, commandProjectGuidanceChoice(command));
         if (didInstall) {
             setInstalledCanonicalPaths(command, canonicalPathsForPack('workflows'));
         }

package/dist/commands/pjm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/pjm/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAuB,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAA0B,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAiBnE,UAAU,sBAAsB;IAC9B,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;IAChD,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,uBAAuB,EAAE,OAAO,uBAAuB,CAAC;IACxD,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,cAAc,EAAE,OAAO,cAAc,CAAC;IACtC,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;CACvD;AA6FD,wBAAgB,gBAAgB,CAC9B,SAAS,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAC9C,OAAO,CA8JT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/pjm/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAuB,MAAM,sBAAsB,CAAC;AAGhF,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAA0B,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAiBnE,UAAU,sBAAsB;IAC9B,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;IAChD,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,uBAAuB,EAAE,OAAO,uBAAuB,CAAC;IACxD,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,cAAc,EAAE,OAAO,cAAc,CAAC;IACtC,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;CACvD;AA6FD,wBAAgB,gBAAgB,CAC9B,SAAS,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAC9C,OAAO,CAyLT"}

package/dist/commands/pjm/index.js

@@ -1,5 +1,6 @@
 import { resolve } from 'node:path';
 import { buildCommandContext } from '../../app/command-context.js';
+import { formatAgentsMdGuidanceResult } from '../shared/agents-md.js';
 import { readGlobalOptions } from '../shared/shared.utils.js';
 import { resolveAssetsRoot } from '../../fs/assets.js';
 import { resolveProjectRoot } from '../../fs/paths.js';
@@ -102,11 +103,27 @@ export function createPjmCommand(overrides = {}) {
                 templatesRoot: resolve(projectRoot, '.oat', 'templates'),
                 home: context.home,
             });
+            const guidanceIncomplete = Object.values(result.guidance ?? {}).some(({ action }) => action === 'manual-required' || action === 'blocked');
             if (context.json) {
-                context.logger.json({ status: 'ok', ...result });
+                if (guidanceIncomplete) {
+                    context.logger.json({
+                        status: 'partial',
+                        scaffold: { status: 'complete' },
+                        adoption: { status: 'declared' },
+                        created: result.created,
+                        skipped: result.skipped,
+                        guidance: result.guidance,
+                    });
+                }
+                else {
+                    const { guidance: _guidance, ...completed } = result;
+                    context.logger.json({ status: 'ok', ...completed });
+                }
             }
             else {
-                context.logger.info(`Initialized PJM repo reference scaffold at ${result.repoRoot}`);
+                context.logger.info(guidanceIncomplete
+                    ? 'Initialized PJM repo reference scaffold.'
+                    : `Initialized PJM repo reference scaffold at ${result.repoRoot}`);
                 if (result.created.length > 0) {
                     context.logger.info(`Created: ${result.created.join(', ')}`);
                 }
@@ -114,8 +131,16 @@ export function createPjmCommand(overrides = {}) {
                     context.logger.info(`Skipped existing: ${result.skipped.join(', ')}`);
                 }
                 context.logger.info(INSTRUCTIONS_SYNC_HINT);
+                if (guidanceIncomplete) {
+                    context.logger.warn('PJM scaffold and adoption completed; AGENTS.md guidance requires manual action.');
+                    for (const guidance of Object.values(result.guidance ?? {})) {
+                        for (const line of formatAgentsMdGuidanceResult(guidance)) {
+                            context.logger.info(line);
+                        }
+                    }
+                }
             }
-            process.exitCode = 0;
+            process.exitCode = guidanceIncomplete ? 1 : 0;
         }
         catch (error) {
             reportError(context, error);

package/dist/commands/pjm/init.d.ts

@@ -1,3 +1,4 @@
+import { type UpsertSectionResult } from '../shared/agents-md.js';
 export interface InitializeRepoReferenceOptions {
     repoRoot: string;
     assetsRoot: string;
@@ -9,6 +10,10 @@ export interface RepoReferenceInitResult {
     repoRoot: string;
     created: string[];
     skipped: string[];
+    guidance: {
+        projectManagement: UpsertSectionResult;
+        decisions: UpsertSectionResult;
+    };
 }
 export declare const INSTRUCTIONS_SYNC_HINT: string;
 export declare const CANONICAL_REPO_REFERENCE_PATHS: readonly [...("AGENTS.md" | "README.md" | "pjm/AGENTS.md" | "pjm/current-state.md" | "pjm/handoffs/README.md" | "pjm/roadmap.md" | "reference/AGENTS.md")[], "pjm/backlog/index.md", "pjm/backlog/completed.md", "pjm/backlog/items/.gitkeep", "pjm/backlog/archived/.gitkeep", "reference/decisions/AGENTS.md", "reference/decisions/index.md"];

package/dist/commands/pjm/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/pjm/init.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAoBD,eAAO,MAAM,sBAAsB,QAEiD,CAAC;AAerF,eAAO,MAAM,8BAA8B,kVAIjC,CAAC;AAEX,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAiC7C,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,uBAAuB,CAAC,CA8GlC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/pjm/init.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,4BAA4B,CAAC;AAMpC,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE;QACR,iBAAiB,EAAE,mBAAmB,CAAC;QACvC,SAAS,EAAE,mBAAmB,CAAC;KAChC,CAAC;CACH;AAoBD,eAAO,MAAM,sBAAsB,QAEiD,CAAC;AAerF,eAAO,MAAM,8BAA8B,kVAIjC,CAAC;AAEX,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAiC7C,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,uBAAuB,CAAC,CAsHlC"}

package/dist/commands/pjm/init.js

@@ -4,7 +4,7 @@ import { initializeBacklog } from '../backlog/init.js';
 import { buildDecisionAgentsSectionBody, DECISION_AGENTS_SECTION_KEY, initializeScopedDecisionAgentsGuidance, } from '../decision/agents-guidance.js';
 import { initializeDecisionRecords } from '../decision/init.js';
 import { buildProjectManagementAgentsSectionBody, PROJECT_MANAGEMENT_AGENTS_SECTION_KEY, } from '../init/tools/project-management/agents-guidance.js';
-import { upsertAgentsMdSection } from '../shared/agents-md.js';
+import { upsertAgentsMdSections, } from '../shared/agents-md.js';
 import { stripTemplateFrontmatter } from '../shared/strip-template-frontmatter.js';
 import { readOatConfig, writeOatConfig } from '../../config/oat-config.js';
 import { resolvePjmTemplate } from './template-source.js';
@@ -138,11 +138,27 @@ export async function initializeRepoReference(options) {
     // it is written here — after scaffold verification and alongside the
     // `pjm.initialized` marker — so installing the capability at any scope never
     // implies that this repository adopted PJM.
-    await upsertAgentsMdSection(projectRoot, PROJECT_MANAGEMENT_AGENTS_SECTION_KEY, buildProjectManagementAgentsSectionBody());
-    await upsertAgentsMdSection(projectRoot, DECISION_AGENTS_SECTION_KEY, buildDecisionAgentsSectionBody());
+    const guidance = await upsertAgentsMdSections(projectRoot, [
+        {
+            key: PROJECT_MANAGEMENT_AGENTS_SECTION_KEY,
+            body: buildProjectManagementAgentsSectionBody(),
+        },
+        {
+            key: DECISION_AGENTS_SECTION_KEY,
+            body: buildDecisionAgentsSectionBody(),
+        },
+    ]);
     return {
         repoRoot: options.repoRoot,
         created,
         skipped,
+        guidance: {
+            projectManagement: guidance[PROJECT_MANAGEMENT_AGENTS_SECTION_KEY] ?? {
+                action: 'no-change',
+            },
+            decisions: guidance[DECISION_AGENTS_SECTION_KEY] ?? {
+                action: 'no-change',
+            },
+        },
     };
 }

package/dist/commands/project/dispatch/index.d.ts

@@ -0,0 +1,10 @@
+import { type CommandContext, type GlobalOptions } from '../../../app/command-context.js';
+import { Command } from 'commander';
+export interface ProjectDispatchCommandDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    resolveProjectRoot: (cwd: string) => Promise<string>;
+    readFile: (path: string) => Promise<string>;
+    readStdin: () => Promise<string>;
+}
+export declare function createProjectDispatchCommand(overrides?: Partial<ProjectDispatchCommandDependencies>): Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/project/dispatch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/dispatch/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,MAAM,WAAW,kCAAkC;IACjD,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAClC;AA0ID,wBAAgB,4BAA4B,CAC1C,SAAS,GAAE,OAAO,CAAC,kCAAkC,CAAM,GAC1D,OAAO,CA2BT"}