@webpresso/agent-kit 0.21.3 → 0.21.5

package/dist/esm/audit/resolve-audit-script.js

@@ -0,0 +1,27 @@
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+/**
+ * Resolve the absolute path of a Bun audit script (`audit-tph.ts`,
+ * `audit-tph-e2e.ts`) living in the sibling `audit/` directory two levels up
+ * from the caller.
+ *
+ * `../../audit/` is correct relative to the caller in BOTH layouts:
+ *   - dev:       `src/{cli,mcp}/.../audit.ts` → `src/audit/`
+ *   - published: `dist/esm/{cli,mcp}/.../audit.js` → `dist/esm/audit/`
+ *
+ * The npm tarball ships only `dist/` (never `src/`), so the dev `.ts` source is
+ * absent there — fall back to the compiled `.js` sibling the build emits. The
+ * previous CLI resolver instead hand-rolled a `<bundle>/src/audit/<name>.ts`
+ * path that does not exist in dist, which made `bun` fail with
+ * "Module not found"; the MCP twin reached for the unshipped `src/audit/` via
+ * `resolvePackageAsset` and failed the same way.
+ */
+export function resolveAuditScriptPath(name, { moduleUrl, exists = existsSync }) {
+    const sourceUrl = new URL(`../../audit/${name}`, moduleUrl);
+    if (exists(sourceUrl)) {
+        return fileURLToPath(sourceUrl);
+    }
+    const compiledUrl = new URL(`../../audit/${name.replace(/\.ts$/, '.js')}`, moduleUrl);
+    return fileURLToPath(compiledUrl);
+}
+//# sourceMappingURL=resolve-audit-script.js.map

package/dist/esm/blueprint/db/enums.d.ts

@@ -65,8 +65,8 @@ export declare const reviewCadenceSchema: z.ZodEnum<{
     quarterly: "quarterly";
 }>;
 export declare const visibilitySchema: z.ZodEnum<{
-    private: "private";
     public: "public";
+    private: "private";
 }>;
 export declare const taskFileOpSchema: z.ZodEnum<{
     create: "create";

package/dist/esm/blueprint/index.d.ts

@@ -16,7 +16,6 @@ export { validatePlanTemplate } from './core/validation/template.js';
 export { type BlueprintDiff, type DiffChange, type DiffFieldChange, formatDiffForDisplay, generateBlueprintDiff, } from './history/diff.js';
 export { checkAllCheckboxes, checkFirstCheckbox, extractCodeBlocks, extractTaskSection, updateBlockedReason, updateTaskStatus, } from './markdown/helpers.js';
 export { applyBlueprintLifecycle, type BlueprintLifecycleIntent, type BlueprintLifecycleResult, type LifecycleTaskStatus, } from './lifecycle/engine.js';
-export { type GraphEdge, type GraphEdgeType, type GraphLayout, type GraphNode, type GraphNodeType, type NormalizedGraph, parseMermaidToGraph, serializeGraphToMermaid, taskGraphToNormalizedGraph, } from './graph/index.js';
 export type { BlueprintQueryFilters, BlueprintQueryResult, BlueprintQuerySummary, BlueprintRecord, BlueprintSortField, BlueprintSortOptions, Complexity, SortDirection, TaskStatus, } from './query/types.js';
 export { isBlueprintStatus, isComplexity, isTaskStatus } from './query/types.js';
 export { BlueprintNotFoundError } from './utils/errors.js';

package/dist/esm/blueprint/index.js

@@ -17,8 +17,6 @@ export { formatDiffForDisplay, generateBlueprintDiff, } from './history/diff.js'
 // Markdown helpers (pure functions)
 export { checkAllCheckboxes, checkFirstCheckbox, extractCodeBlocks, extractTaskSection, updateBlockedReason, updateTaskStatus, } from './markdown/helpers.js';
 export { applyBlueprintLifecycle, } from './lifecycle/engine.js';
-// Graph model + Mermaid integration
-export { parseMermaidToGraph, serializeGraphToMermaid, taskGraphToNormalizedGraph, } from './graph/index.js';
 export { isBlueprintStatus, isComplexity, isTaskStatus } from './query/types.js';
 export { BlueprintNotFoundError } from './utils/errors.js';
 // Evidence Contract (F10) — pin per-kind evidence rules at zod parse time.

package/dist/esm/blueprint/local.d.ts

@@ -4,9 +4,6 @@
  * These exports use Node.js APIs (fs, simple-git) and are NOT compatible with Cloudflare Workers.
  * For Workers-safe functions, use the main 'webpresso/blueprint' entry point.
  */
-export type { FalseDependency, ParallelizeResult, TaskFiles, TaskPairAnalysis, } from './dag/local/independence.js';
-export { createMockPackageGraph, IndependenceDetector } from './dag/local/independence.js';
-export { createMockFileSystem, PackageGraph, realFileSystem } from './dag/local/package-graph.js';
 export { type AcceptanceCriteria, type Blueprint, buildRoadmapModel, buildBlueprintProgressBridgeState, type BlueprintStatus, type BlueprintTaskStatus, checkAcceptanceCriteria, checkAllCheckboxes, checkChangelog, checkFirstCheckbox, complexitySchema, type CriteriaResult, extractTaskSection, formatDiffForDisplay, generateBlueprintDiff, isBlueprintStatus, isComplexity, isTaskStatus, lifecycleBlueprintStatusSchema, normalizeOmxTeamTaskSnapshot, type OmxTeamTaskSnapshot, type Phase, parseBlueprint, type PlanComplexity, type PlanFrontmatter, planStatusSchema, projectBlueprintLifecycleFromRuntime, resolveBlueprintProgressBridgePath, type RoadmapModel, type RoadmapNode, type RoadmapRollup, type RoadmapLike, serializeBlueprint, type Task, taskStatusSchema, type TaskStatusValue, updateBlockedReason, updateTaskStatus, type ValidationResult, validateEmbeddedPhases, validatePlanLinks, validatePlanState, validatePlanTemplate, } from './index.js';
 export { BlueprintCreationService, type BlueprintCreationServiceOptions, type BlueprintDraft, type CreateBlueprintInput, type CreatedBlueprint, } from './service/BlueprintCreationService.js';
 export { type BlueprintQueryOptions, BlueprintService, type BlueprintSummary, } from './service/BlueprintService.js';

package/dist/esm/blueprint/local.js

@@ -4,8 +4,6 @@
  * These exports use Node.js APIs (fs, simple-git) and are NOT compatible with Cloudflare Workers.
  * For Workers-safe functions, use the main 'webpresso/blueprint' entry point.
  */
-export { createMockPackageGraph, IndependenceDetector } from './dag/local/independence.js';
-export { createMockFileSystem, PackageGraph, realFileSystem } from './dag/local/package-graph.js';
 // Workers-safe exports for convenience (explicit re-export to avoid wildcard)
 export { buildRoadmapModel, buildBlueprintProgressBridgeState, checkAcceptanceCriteria, checkAllCheckboxes, checkChangelog, checkFirstCheckbox, complexitySchema, extractTaskSection, formatDiffForDisplay, generateBlueprintDiff, isBlueprintStatus, isComplexity, isTaskStatus, lifecycleBlueprintStatusSchema, normalizeOmxTeamTaskSnapshot, parseBlueprint, planStatusSchema, projectBlueprintLifecycleFromRuntime, resolveBlueprintProgressBridgePath, serializeBlueprint, taskStatusSchema, updateBlockedReason, updateTaskStatus, validateEmbeddedPhases, validatePlanLinks, validatePlanState, validatePlanTemplate, } from './index.js';
 // Services (require filesystem/git)

package/dist/esm/blueprint/service/BlueprintCreationService.js

@@ -4,7 +4,7 @@ import path from 'node:path';
 import { parseBlueprint } from '#core/parser';
 import { scanBlueprintDirectory } from '#service/scanner';
 import { resolveBlueprintRoot } from '#utils/blueprint-root';
-import { resolvePackageAsset } from '#utils/package-assets';
+import { resolvePackageAssetPreferred } from '#utils/package-assets';
 const RESERVED_BLUEPRINT_SLUGS = new Set([
     'draft',
     'planned',
@@ -13,7 +13,10 @@ const RESERVED_BLUEPRINT_SLUGS = new Set([
     'completed',
     'archived',
 ]);
-const DEFAULT_TEMPLATE_PATH = resolvePackageAsset('docs/templates/blueprint.md');
+const DEFAULT_TEMPLATE_PATH = resolvePackageAssetPreferred([
+    'docs/templates/blueprint.md',
+    'catalog/docs/templates/blueprint.md',
+]);
 function formatDate(date) {
     return date.toISOString().split('T')[0] ?? date.toISOString();
 }

package/dist/esm/blueprint/utils/package-assets.d.ts

@@ -3,4 +3,15 @@
  * package root) is found. Works whether running from src/ or dist/esm/.
  */
 export declare function resolvePackageAsset(relativeFromRoot: string): string;
+/**
+ * Resolve the first existing candidate, in priority order. Use when an asset
+ * lives at one path in the source checkout but a different path in the
+ * published tarball — e.g. templates authored under repo-root `docs/templates/`
+ * but shipped under `catalog/docs/templates/` because the npm `files` list
+ * includes `catalog/` and not `docs/`. Prefers the dev/source location and
+ * falls back to the shipped one, mirroring `bin/_run.js`'s source→built path
+ * translation. Falls back to cwd-relative on the first candidate when none
+ * exist, matching `resolvePackageAsset`'s last-resort behavior.
+ */
+export declare function resolvePackageAssetPreferred(candidates: readonly string[]): string;
 //# sourceMappingURL=package-assets.d.ts.map

package/dist/esm/blueprint/utils/package-assets.js

@@ -1,10 +1,10 @@
 import { existsSync } from 'node:fs';
 import path from 'node:path';
 /**
- * Walk up from this file's location until the given path (relative to the
- * package root) is found. Works whether running from src/ or dist/esm/.
+ * Walk up from this file's location looking for `relativeFromRoot`. Returns the
+ * first existing match, or `null` if none is found within the ancestor budget.
  */
-export function resolvePackageAsset(relativeFromRoot) {
+function findPackageAsset(relativeFromRoot) {
     let dir = path.dirname(new URL(import.meta.url).pathname);
     for (let i = 0; i < 8; i++) {
         const candidate = path.join(dir, relativeFromRoot);
@@ -15,6 +15,35 @@ export function resolvePackageAsset(relativeFromRoot) {
             break;
         dir = parent;
     }
-    return path.join(process.cwd(), relativeFromRoot);
+    return null;
+}
+/**
+ * Walk up from this file's location until the given path (relative to the
+ * package root) is found. Works whether running from src/ or dist/esm/.
+ */
+export function resolvePackageAsset(relativeFromRoot) {
+    return findPackageAsset(relativeFromRoot) ?? path.join(process.cwd(), relativeFromRoot);
+}
+/**
+ * Resolve the first existing candidate, in priority order. Use when an asset
+ * lives at one path in the source checkout but a different path in the
+ * published tarball — e.g. templates authored under repo-root `docs/templates/`
+ * but shipped under `catalog/docs/templates/` because the npm `files` list
+ * includes `catalog/` and not `docs/`. Prefers the dev/source location and
+ * falls back to the shipped one, mirroring `bin/_run.js`'s source→built path
+ * translation. Falls back to cwd-relative on the first candidate when none
+ * exist, matching `resolvePackageAsset`'s last-resort behavior.
+ */
+export function resolvePackageAssetPreferred(candidates) {
+    for (const relativeFromRoot of candidates) {
+        const found = findPackageAsset(relativeFromRoot);
+        if (found)
+            return found;
+    }
+    const primary = candidates[0];
+    if (primary === undefined) {
+        throw new Error('resolvePackageAssetPreferred requires at least one candidate path');
+    }
+    return path.join(process.cwd(), primary);
 }
 //# sourceMappingURL=package-assets.js.map

package/dist/esm/build/sync-catalog-doc-templates.d.ts

@@ -0,0 +1,23 @@
+#!/usr/bin/env bun
+/**
+ * sync-catalog-doc-templates.ts
+ *
+ * `docs/templates/` (repo root) is the editable source of truth for the
+ * blueprint / doc templates. `catalog/docs/templates/` is the published +
+ * scaffolded mirror: the npm `files` list ships `catalog/` but NOT repo-root
+ * `docs/` (which holds internal docs that must stay private), and `wp init`
+ * scaffolds templates into a consumer from `catalog/docs/templates/`.
+ *
+ * The two MUST stay byte-identical. Nothing synced them before, so they
+ * drifted — this script regenerates the mirror from the source and is wired
+ * into the build. The colocated drift test fails CI if they ever diverge.
+ *
+ * Default: regenerate the mirror from the source.
+ * `--check`: exit non-zero and list drift without writing (CI / pre-publish).
+ */
+/**
+ * Names that are out of sync between source and mirror: content mismatch,
+ * missing from the mirror, or orphaned in the mirror.
+ */
+export declare function diffDocTemplateMirror(): string[];
+//# sourceMappingURL=sync-catalog-doc-templates.d.ts.map

package/dist/esm/build/sync-catalog-doc-templates.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env bun
+/**
+ * sync-catalog-doc-templates.ts
+ *
+ * `docs/templates/` (repo root) is the editable source of truth for the
+ * blueprint / doc templates. `catalog/docs/templates/` is the published +
+ * scaffolded mirror: the npm `files` list ships `catalog/` but NOT repo-root
+ * `docs/` (which holds internal docs that must stay private), and `wp init`
+ * scaffolds templates into a consumer from `catalog/docs/templates/`.
+ *
+ * The two MUST stay byte-identical. Nothing synced them before, so they
+ * drifted — this script regenerates the mirror from the source and is wired
+ * into the build. The colocated drift test fails CI if they ever diverge.
+ *
+ * Default: regenerate the mirror from the source.
+ * `--check`: exit non-zero and list drift without writing (CI / pre-publish).
+ */
+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { argv, exit } from 'node:process';
+import { fileURLToPath } from 'node:url';
+const PACKAGE_ROOT = dirname(dirname(import.meta.dirname));
+const SOURCE_DIR = join(PACKAGE_ROOT, 'docs', 'templates');
+const MIRROR_DIR = join(PACKAGE_ROOT, 'catalog', 'docs', 'templates');
+function listFiles(dir) {
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir, { withFileTypes: true })
+        .filter((entry) => entry.isFile())
+        .map((entry) => entry.name)
+        .sort();
+}
+/**
+ * Names that are out of sync between source and mirror: content mismatch,
+ * missing from the mirror, or orphaned in the mirror.
+ */
+export function diffDocTemplateMirror() {
+    const sourceFiles = listFiles(SOURCE_DIR);
+    const mirrorFiles = listFiles(MIRROR_DIR);
+    const names = [...new Set([...sourceFiles, ...mirrorFiles])].sort();
+    const drift = [];
+    for (const name of names) {
+        const inSource = sourceFiles.includes(name);
+        const inMirror = mirrorFiles.includes(name);
+        if (!inSource || !inMirror) {
+            drift.push(name);
+            continue;
+        }
+        if (readFileSync(join(SOURCE_DIR, name), 'utf8') !== readFileSync(join(MIRROR_DIR, name), 'utf8')) {
+            drift.push(name);
+        }
+    }
+    return drift;
+}
+/** Regenerate the mirror from the source: copy every file, drop orphans. */
+function syncDocTemplateMirror() {
+    mkdirSync(MIRROR_DIR, { recursive: true });
+    const sourceFiles = listFiles(SOURCE_DIR);
+    for (const name of listFiles(MIRROR_DIR)) {
+        if (!sourceFiles.includes(name))
+            rmSync(join(MIRROR_DIR, name));
+    }
+    for (const name of sourceFiles) {
+        cpSync(join(SOURCE_DIR, name), join(MIRROR_DIR, name));
+    }
+    return sourceFiles.length;
+}
+function main() {
+    if (!existsSync(SOURCE_DIR)) {
+        console.error(`doc templates source not found: ${SOURCE_DIR}`);
+        exit(1);
+    }
+    if (argv.includes('--check')) {
+        const drift = diffDocTemplateMirror();
+        if (drift.length > 0) {
+            console.error([
+                'catalog/docs/templates/ is out of sync with docs/templates/:',
+                ...drift.map((name) => `  - ${name}`),
+                'Run `bun src/build/sync-catalog-doc-templates.ts` and commit the result.',
+            ].join('\n'));
+            exit(1);
+        }
+        console.log('catalog/docs/templates/ is in sync with docs/templates/');
+        return;
+    }
+    const count = syncDocTemplateMirror();
+    console.log(`Synced ${count} template(s) → catalog/docs/templates/`);
+}
+// Run as a script, but stay side-effect-free when imported (e.g. by the test).
+if (fileURLToPath(import.meta.url) === argv[1]) {
+    main();
+}
+//# sourceMappingURL=sync-catalog-doc-templates.js.map

package/dist/esm/cli/commands/audit.js

@@ -9,6 +9,7 @@ import { existsSync, readFileSync } from 'node:fs';
 import path from 'node:path';
 import { runAuditDispatch } from './audit-core.js';
 import { runStryker } from '#audit/run-stryker';
+import { resolveAuditScriptPath } from '#audit/resolve-audit-script';
 const REPO_AUDIT_REGISTRY = {
     'catalog-drift': async (root) => (await import('#audit/repo-guardrails')).auditCatalogDrift(root),
     'package-surface': async (root) => (await import('#audit/package-surface')).auditPackageSurface(root),
@@ -119,13 +120,7 @@ const AUDIT_KINDS = [
 ];
 const AUDIT_KIND_LIST = AUDIT_KINDS.join(', ');
 function resolveAuditScript(name) {
-    const fromSource = new URL(`../../audit/${name}`, import.meta.url);
-    if (existsSync(fromSource)) {
-        return fromSource.pathname;
-    }
-    const bundleDir = path.dirname(new URL(import.meta.url).pathname);
-    const packageRoot = path.resolve(bundleDir, '..');
-    return path.join(packageRoot, 'src', 'audit', name);
+    return resolveAuditScriptPath(name, { moduleUrl: import.meta.url });
 }
 async function runAuditScript(script, extraArgs) {
     const runtime = process.env.BUN_INSTALL ? 'bun' : 'bun';

package/dist/esm/cli/commands/blueprint/router.js

@@ -6,7 +6,7 @@ import { blueprintToSpecKit } from '#export/spec-kit/index';
 import { getProjectRoot } from '#cli/utils';
 import { resolveBlueprintRoot } from '#utils/blueprint-root';
 import { applyBlueprintLifecycleToFile, BlueprintCreationService, BlueprintService, complexitySchema, relativeBlueprintSlug, parseBlueprint, planStatusSchema, runBlueprintAudit, resolveBlueprintFile, serializeBlueprint, validateAllTasksDone, } from '#local';
-import { resolvePackageAsset } from '#utils/package-assets';
+import { resolvePackageAssetPreferred } from '#utils/package-assets';
 import { describeBlueprintExecutionRuntime, buildBlueprintLaunchSpec, buildStoppedRuntimeEvidence, controlBlueprintExecution, initializeBlueprintExecutionProgressBridge, launchBlueprintExecution, persistBlueprintExecutionArtifacts, persistBlueprintExecutionMetadata, recordLaunchFailure, reconcileBlueprintRuntimeSnapshot, readBlueprintExecutionState, syncBlueprintExecutionProgress, writeBlueprintRuntimeSnapshot, } from './execution.js';
 import { advanceTask as advanceTaskMutation, finalizeBlueprint as finalizeBlueprintMutation, promoteBlueprint as promoteBlueprintMutation, } from './mutations.js';
 import { BlueprintAuditFailedError, executeBlueprintSubcommand } from './router-dispatch.js';
@@ -40,7 +40,10 @@ function assertBlueprintCanMoveToStatus(blueprint, nextStatus) {
  * when the lookup fails in unrelated contexts (e.g. `wp --help`).
  */
 function resolveRepoBlueprintTemplatePath() {
-    return resolvePackageAsset('docs/templates/blueprint.md');
+    return resolvePackageAssetPreferred([
+        'docs/templates/blueprint.md',
+        'catalog/docs/templates/blueprint.md',
+    ]);
 }
 function todayIsoDate() {
     return new Date().toISOString().split('T')[0] ?? new Date().toISOString();

package/dist/esm/cli/commands/blueprint/template-resolver.js

@@ -1,12 +1,16 @@
 import { readdirSync } from 'node:fs';
 import path from 'node:path';
-import { resolvePackageAsset } from '#utils/package-assets.js';
+import { resolvePackageAssetPreferred } from '#utils/package-assets.js';
 /**
- * Default templates directory: docs/templates/ resolved relative to the
- * package root (same strategy as resolveRepoBlueprintTemplatePath in router.ts).
+ * Default templates directory: docs/templates/ in a source checkout, falling
+ * back to the shipped catalog/docs/templates/ in the published package (same
+ * strategy as resolveRepoBlueprintTemplatePath in router.ts).
  */
 function defaultTemplatesDir() {
-    return path.dirname(resolvePackageAsset('docs/templates/blueprint.md'));
+    return path.dirname(resolvePackageAssetPreferred([
+        'docs/templates/blueprint.md',
+        'catalog/docs/templates/blueprint.md',
+    ]));
 }
 /**
  * List available templates from `templatesDir` (defaults to docs/templates/).

package/dist/esm/cli/commands/init/host-visibility.js

@@ -5,6 +5,8 @@ export const AGENT_HOSTS = ['codex', 'claude', 'opencode'];
 export const REQUIRED_CORE_CAPABILITIES = ['verify', 'plan-refine'];
 export const VISIBILITY_STATUSES = ['visible-now', 'visible-after-restart', 'not-visible'];
 export function parseAgentHosts(value) {
+    if (value?.trim() === 'none')
+        return [];
     if (!value || value.trim().length === 0 || value.trim() === 'all')
         return [...AGENT_HOSTS];
     const out = [];
@@ -19,7 +21,7 @@ export function parseAgentHosts(value) {
             unknown.push(token);
     }
     if (unknown.length > 0) {
-        throw new Error(`Unknown host(s): ${unknown.join(', ')}. Expected one of: ${AGENT_HOSTS.join(', ')}, all.`);
+        throw new Error(`Unknown host(s): ${unknown.join(', ')}. Expected one of: ${AGENT_HOSTS.join(', ')}, all, none.`);
     }
     return [...new Set(out)];
 }
@@ -54,7 +56,7 @@ export function hostSkillRoots(repoRoot, host, homeDir = homedir()) {
     }
 }
 export function auditHostSkillVisibility(input) {
-    const selectedHosts = input.hosts && input.hosts.length > 0 ? [...input.hosts] : [...AGENT_HOSTS];
+    const selectedHosts = input.hosts ? [...input.hosts] : [...AGENT_HOSTS];
     const requiredCapabilities = input.requiredCapabilities && input.requiredCapabilities.length > 0
         ? [...input.requiredCapabilities]
         : [...REQUIRED_CORE_CAPABILITIES];

package/dist/esm/cli/commands/init/index.js

@@ -6,7 +6,7 @@
  * config keys, and generated surfaces it owns while leaving consumer-owned
  * divergent files untouched unless `--overwrite` is passed.
  */
-import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { basename, dirname, join, relative } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { isTelemetryEnabled, reportTthw } from '#telemetry/setup-tthw';
@@ -26,7 +26,7 @@ import { GENERATED_PATHS_BLOCK, patchGitignore } from './gitignore-patcher.js';
 import { scaffoldAgentsMd } from './scaffold-agents-md.js';
 import { scaffoldBlueprints } from './scaffold-blueprints.js';
 import { scaffoldDocs } from './scaffold-docs.js';
-import { scaffoldBaseKit } from './scaffold-base-kit.js';
+import { BASE_KIT_QUALITY_TARGETS, collectRuntimeContractGuidance, scaffoldBaseKit, } from './scaffold-base-kit.js';
 import { scaffoldMonorepoNav } from './scaffold-monorepo-nav.js';
 import { REQUIRED_CORE_CAPABILITIES, auditHostSkillVisibility, parseAgentHosts, serializeHostVisibility, summarizeHostVisibility, } from './host-visibility.js';
 import { scaffoldAgentHooks, trustCodexWebpressoHooksForRepo, trustCodexPresetHooksForUser, } from './scaffolders/agent-hooks/index.js';
@@ -103,6 +103,31 @@ function inferBlueprintsDirOverride(repoRoot, existingConfig) {
     }
     return relativePath;
 }
+function readPackageJsonSafe(repoRoot) {
+    const packageJsonPath = join(repoRoot, 'package.json');
+    if (!existsSync(packageJsonPath)) {
+        return null;
+    }
+    try {
+        return JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function printRuntimeContractGuidance(packageJson) {
+    const guidance = collectRuntimeContractGuidance(packageJson);
+    console.log('\nRuntime-owned tooling contract:');
+    console.log('  wp now owns execution for test, e2e, lint, format, and typecheck.');
+    console.log('  Keep local dependencies that your tests, configs, or tsconfig types import directly.');
+    if (guidance.keepLocalAuthoringDeps.length > 0) {
+        console.log(`  Keep local authoring deps when imported directly: ${guidance.keepLocalAuthoringDeps.join(', ')}`);
+    }
+    if (guidance.reviewForRemovalDeps.length > 0) {
+        console.log(`  Review execution-only deps for removal if they only powered local binaries: ${guidance.reviewForRemovalDeps.join(', ')}`);
+    }
+    console.log('  Do not blanket-remove devDependencies just because wp can execute the tool.');
+}
 export async function runInit(flags) {
     const startMs = Date.now();
     const cwd = flags.cwd ?? process.cwd();
@@ -612,6 +637,14 @@ export async function runInit(flags) {
         console.log(`  drifted:         ${summary.drifted}`);
         if (options.dryRun)
             console.log(`  would-change:    ${summary['skipped-dry']}`);
+        if (tier3Selection.includes('base-kit')) {
+            const qualityTargets = new Set(BASE_KIT_QUALITY_TARGETS);
+            const qualityResults = baseKitResults.filter((result) => qualityTargets.has(relative(consumer.repoRoot, result.targetPath).replaceAll('\\', '/')));
+            const qualityCreated = qualityResults.filter((result) => result.action === 'created').length;
+            const qualityPreserved = qualityResults.filter((result) => result.action === 'identical').length;
+            const qualityDryRun = qualityResults.filter((result) => result.action === 'skipped-dry').length;
+            console.log(`  repo quality scaffold: ${options.dryRun ? `${qualityDryRun} would be created` : `${qualityCreated} created, ${qualityPreserved} preserved`}`);
+        }
         if (summary.drifted > 0) {
             console.log('\n  Note: some consumer-owned files exist with different content and were left unchanged.\n' +
                 '  Review the drift or re-run with `--overwrite` to force eligible managed files.');
@@ -629,8 +662,13 @@ export async function runInit(flags) {
             };
             writeConfig(consumer.repoRoot, config);
             console.log('\nHost skill visibility:');
-            for (const line of summarizeHostVisibility(consumer.repoRoot, visibilityAudit)) {
-                console.log(line);
+            if (visibilityAudit.selectedHosts.length === 0) {
+                console.log('  hosts: - skipped (--host none)');
+            }
+            else {
+                for (const line of summarizeHostVisibility(consumer.repoRoot, visibilityAudit)) {
+                    console.log(line);
+                }
             }
             const missing = visibilityAudit.results.filter((result) => result.status === 'not-visible');
             if (missing.length > 0) {
@@ -659,7 +697,8 @@ export async function runInit(flags) {
                 }
             }
         }
-        console.log('\nwp init: done.');
+        printRuntimeContractGuidance(options.dryRun ? consumer.packageJson : readPackageJsonSafe(consumer.repoRoot) ?? consumer.packageJson);
+        console.log('\nwp init: setup phases finished.');
         if (omxFailure === 'not-found')
             return EXIT_SETUP_FAIL;
         if (omxFailure === 'spawn-failed')
@@ -698,7 +737,7 @@ export async function runInit(flags) {
         if (!options.dryRun) {
             console.log([
                 '',
-                '✅ Setup complete.',
+                '✅ Setup complete for the verified phases above.',
                 '',
                 '  Next: wp blueprint new "your first task"',
                 '        wp gain          # token savings after your first session',
@@ -730,7 +769,7 @@ export function registerInitCommand(cli, commandName = 'init') {
         .command(commandName, description)
         .option('--with <skills>', withHelp)
         .option('--without <skills>', withoutHelp)
-        .option('--host <hosts>', 'Comma-separated host targets: codex, claude, opencode, all')
+        .option('--host <hosts>', 'Comma-separated host targets: codex, claude, opencode, all, none')
         .option('--all', 'Install every skill (Tier-1 + Tier-2 + all Tier-3)')
         .option('--overwrite', 'Force full-file replacement for eligible managed files (default: reconcile owned content and preserve divergent consumer files)')
         .option('--dry-run', 'Show what would change without writing anything')

package/dist/esm/cli/commands/init/scaffold-base-kit.d.ts

@@ -5,5 +5,17 @@ export interface ScaffoldBaseKitInput {
     options: MergeOptions;
     globalInstall?: boolean;
 }
+export interface RuntimeContractGuidance {
+    keepLocalAuthoringDeps: string[];
+    reviewForRemovalDeps: string[];
+}
+interface PackageJsonLike {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    [key: string]: unknown;
+}
+export declare function collectRuntimeContractGuidance(packageJson: PackageJsonLike | null | undefined): RuntimeContractGuidance;
+export declare const BASE_KIT_QUALITY_TARGETS: string[];
 export declare function scaffoldBaseKit(input: ScaffoldBaseKitInput): MergeResult[];
+export {};
 //# sourceMappingURL=scaffold-base-kit.d.ts.map