@pourkit/cli 0.0.0-next-20260617183635 → 0.0.0-next-20260617220545

package/dist/cli.js

@@ -11941,6 +11941,7 @@ import { createHash as createHash2, randomUUID } from "crypto";
 import path5 from "path";
 import { execFile as execFile2 } from "child_process";
 import { promisify as promisify2 } from "util";
+import { fileURLToPath as fileURLToPath2 } from "url";
 import { confirm, isCancel, log, select, text } from "@clack/prompts";
 
 // providers/github-client.ts
@@ -12088,7 +12089,15 @@ function getWorkflowPackCatalog() {
 function buildOpenCodeSkillProjectionContent(managedSourcePath, sourceContent) {
   const generatedNotice = `Generated from ${managedSourcePath}. Do not edit directly.`;
   if (managedSourcePath.endsWith(".md") || managedSourcePath.endsWith(".mdx")) {
-    return `<!-- ${generatedNotice} -->
+    const comment = `<!-- ${generatedNotice} -->`;
+    const frontmatter = sourceContent.match(
+      /^---\r?\n[\s\S]*?\r?\n---[ \t]*(?:\r?\n|$)/
+    );
+    if (frontmatter) {
+      return `${frontmatter[0]}${comment}
+${sourceContent.slice(frontmatter[0].length)}`;
+    }
+    return `${comment}
 ${sourceContent}`;
   }
   if (managedSourcePath.endsWith(".sh") || managedSourcePath.endsWith(".bash") || managedSourcePath.endsWith(".zsh") || managedSourcePath.endsWith(".py") || managedSourcePath.endsWith(".rb") || managedSourcePath.endsWith(".yml") || managedSourcePath.endsWith(".yaml") || managedSourcePath.endsWith(".toml")) {
@@ -12124,7 +12133,22 @@ function buildWorkflowPackMetadata(enabledAddons) {
 
 // commands/init.ts
 var execFileAsync2 = promisify2(execFile2);
+var __filename2 = fileURLToPath2(import.meta.url);
+var __dirname2 = path5.dirname(__filename2);
 var RELEASE_ADDON_SKILL_NAMES = ["changeset", "promote-release"];
+function resolvePackagedSourceRoot() {
+  return path5.resolve(__dirname2, "..");
+}
+function resolveSourceAssetPath(sourceRoot, ...segments) {
+  const candidatePaths = [
+    path5.join(sourceRoot, ...segments),
+    path5.join(sourceRoot, "dist", ...segments)
+  ];
+  for (const candidatePath of candidatePaths) {
+    if (existsSync18(candidatePath)) return candidatePath;
+  }
+  return path5.join(sourceRoot, "pourkit", ...segments);
+}
 var BASELINE_SKILL_NAMES = [
   "code-review",
   "diagnose",
@@ -12505,14 +12529,31 @@ Use \`fd\` for file discovery, \`rg\` for text search, and direct file reads for
 
 Follow the project's domain docs and conventions documented in \`.pourkit/managed/docs/agents/*\`.
 
-### Managed operating docs
+## Pourkit Workflow Routes
+
+### Issue Tracker
+
+When using Pourkit issue workflows, see \`.pourkit/managed/docs/agents/issue-tracker.md\`.
+
+### Triage Labels
 
-- \`.pourkit/managed/docs/agents/issue-tracker.md\`
-- \`.pourkit/managed/docs/agents/triage-labels.md\`
-- \`.pourkit/managed/docs/agents/naming.md\`
-- \`.pourkit/managed/docs/agents/git-workflow.md\`
-- \`.pourkit/managed/docs/agents/commit-style.md\`
-- \`.pourkit/managed/docs/agents/domain.md\`
+Pourkit workflows use the default triage labels described in \`.pourkit/managed/docs/agents/triage-labels.md\`.
+
+### Domain Docs
+
+Follow the repository domain-documentation layout in \`.pourkit/managed/docs/agents/domain.md\`.
+
+### Issue Naming
+
+PRDs and child issues must follow the naming convention in \`.pourkit/managed/docs/agents/naming.md\`.
+
+### Git Workflow
+
+Branch naming and PR creation guidance lives in \`.pourkit/managed/docs/agents/git-workflow.md\`.
+
+### Commit Style
+
+Agents must write readable conventional commits with bullet-list bodies for non-trivial changes. See \`.pourkit/managed/docs/agents/commit-style.md\`.
 
 ### Project-owned context
 
@@ -12690,16 +12731,24 @@ async function checkExistingLabelConflicts(client, canonicalLabels) {
   }
 }
 async function planInit(options) {
-  const { targetRoot, sourceRoot } = options;
+  const { targetRoot } = options;
+  let sourceRoot = options.sourceRoot ?? resolvePackagedSourceRoot();
+  let usingExplicitSource = Boolean(options.sourceRoot);
   const operations = [];
   const warnings = [];
   let hasLabelConflicts = false;
-  let managedAgentContent;
-  if (sourceRoot) {
-    managedAgentContent = await generateManagedAgentInstructions({
-      sourceRoot
+  if (options.sourceRoot) {
+    warnings.push("--from-local is deprecated; omit it to use packaged assets");
+    operations.push({
+      kind: "warn",
+      reason: "--from-local is deprecated; omit it to use packaged assets",
+      destructive: false,
+      requiresConfirmation: false
     });
   }
+  const managedAgentContent = await generateManagedAgentInstructions({
+    sourceRoot
+  });
   const pm = options.packageManager ?? detectPackageManager(targetRoot);
   if (pm) {
     operations.push({
@@ -12730,39 +12779,28 @@ async function planInit(options) {
   const agentFiles = await discoverAgentFiles(targetRoot);
   if (agentFiles.length > 0) {
     for (const f of agentFiles) {
-      if (sourceRoot) {
-        const agentFileMode = options.conflictPolicy?.agentFile ?? "both";
-        const basename = path5.basename(f);
-        if (agentFileMode === "skip" || agentFileMode === "agents" && basename !== "AGENTS.md" || agentFileMode === "claude" && basename !== "CLAUDE.md") {
-          operations.push({
-            kind: "skip",
-            path: f,
-            ownership: "project-owned",
-            reason: `Existing agent file skipped per policy: ${basename}`,
-            requiresConfirmation: false,
-            destructive: false
-          });
-          continue;
-        }
-        operations.push({
-          kind: "update",
-          path: f,
-          ownership: "managed",
-          reason: `Update existing ${basename} with Pourkit managed block`,
-          requiresConfirmation: false,
-          destructive: false,
-          content: managedAgentContent
-        });
-      } else {
+      const agentFileMode = options.conflictPolicy?.agentFile ?? "both";
+      const basename = path5.basename(f);
+      if (agentFileMode === "skip" || agentFileMode === "agents" && basename !== "AGENTS.md" || agentFileMode === "claude" && basename !== "CLAUDE.md") {
         operations.push({
           kind: "skip",
           path: f,
           ownership: "project-owned",
-          reason: `Existing agent file: ${path5.basename(f)}`,
+          reason: `Existing agent file skipped per policy: ${basename}`,
           requiresConfirmation: false,
           destructive: false
         });
+        continue;
       }
+      operations.push({
+        kind: "update",
+        path: f,
+        ownership: "managed",
+        reason: `Update existing ${basename} with Pourkit managed block`,
+        requiresConfirmation: false,
+        destructive: false,
+        content: managedAgentContent
+      });
     }
   }
   const merlleState = await discoverMerlleState(targetRoot);
@@ -12856,7 +12894,10 @@ async function planInit(options) {
         destructive: false,
         requiresConfirmation: false
       });
-    } else {
+      sourceRoot = resolvePackagedSourceRoot();
+      usingExplicitSource = false;
+    }
+    {
       let sourceMeta;
       try {
         sourceMeta = await discoverLocalSource(sourceRoot);
@@ -12869,17 +12910,19 @@ async function planInit(options) {
           releaseChannel: "unknown",
           latestTag: null
         };
-        warnings.push(
-          "Source is not a Git repository; version metadata unavailable"
-        );
-        operations.push({
-          kind: "warn",
-          reason: "Source is not a Git repository; version metadata unavailable",
-          destructive: false,
-          requiresConfirmation: false
-        });
+        if (usingExplicitSource) {
+          warnings.push(
+            "Source is not a Git repository; version metadata unavailable"
+          );
+          operations.push({
+            kind: "warn",
+            reason: "Source is not a Git repository; version metadata unavailable",
+            destructive: false,
+            requiresConfirmation: false
+          });
+        }
       }
-      if (sourceMeta.sourceDirty) {
+      if (usingExplicitSource && sourceMeta.sourceDirty) {
         warnings.push("Local source has uncommitted changes");
         operations.push({
           kind: "warn",
@@ -12894,15 +12937,13 @@ async function planInit(options) {
           plannedSkillDests.add(op.path);
         }
       }
-      const packagedManagedSkills = path5.join(
+      const packagedManagedSkills = resolveSourceAssetPath(
         sourceRoot,
-        "pourkit",
         "managed",
         "skills"
       );
-      const packagedReleaseAddonSkills = path5.join(
+      const packagedReleaseAddonSkills = resolveSourceAssetPath(
         sourceRoot,
-        "pourkit",
         "managed",
         "addons",
         "release",
@@ -13151,9 +13192,8 @@ async function planInit(options) {
           destructive: false
         });
       }
-      const packagedManagedDocAgents = path5.join(
+      const packagedManagedDocAgents = resolveSourceAssetPath(
         sourceRoot,
-        "pourkit",
         "managed",
         "docs",
         "agents"
@@ -13231,9 +13271,8 @@ Do not edit this file.
         }
       }
       if (options.releaseWorkflow?.enabled) {
-        const packagedReleaseAddonDocs = path5.join(
+        const packagedReleaseAddonDocs = resolveSourceAssetPath(
           sourceRoot,
-          "pourkit",
           "managed",
           "addons",
           "release",
@@ -13267,9 +13306,8 @@ Do not edit this file.
           }
         }
       }
-      const packagedManagedPrompts = path5.join(
+      const packagedManagedPrompts = resolveSourceAssetPath(
         sourceRoot,
-        "pourkit",
         "managed",
         "prompts"
       );
@@ -13369,9 +13407,8 @@ Do not edit this file.
         "schema",
         "pourkit.schema.json"
       );
-      const srcSchemaJson = path5.join(
+      const srcSchemaJson = resolveSourceAssetPath(
         sourceRoot,
-        "pourkit",
         "schema",
         "pourkit.schema.json"
       );
@@ -13405,9 +13442,8 @@ Do not edit this file.
         "schema",
         "pourkit.schema.hash"
       );
-      const srcSchemaHash = path5.join(
+      const srcSchemaHash = resolveSourceAssetPath(
         sourceRoot,
-        "pourkit",
         "schema",
         "pourkit.schema.hash"
       );
@@ -13562,7 +13598,7 @@ ${gitignoreContent}${MANAGED_BLOCK_END}
           conflict: "already exists"
         });
       }
-      const sourceLabel = sourceMeta.versionSource === "local-git" ? `Init from local source (${sourceMeta.branch}@${sourceMeta.sha.slice(0, 7)})` : "Init from local source (non-Git)";
+      const sourceLabel = usingExplicitSource ? sourceMeta.versionSource === "local-git" ? `Init from local source (${sourceMeta.branch}@${sourceMeta.sha.slice(0, 7)})` : "Init from local source (non-Git)" : "Init from packaged assets";
       operations.push({
         kind: "copy",
         sourcePath: sourceRoot,
@@ -13573,18 +13609,10 @@ ${gitignoreContent}${MANAGED_BLOCK_END}
         destructive: false
       });
     }
-  } else {
-    warnings.push("No --from-local source provided");
-    operations.push({
-      kind: "warn",
-      reason: "No --from-local source provided",
-      destructive: false,
-      requiresConfirmation: false
-    });
   }
   return {
     targetRoot,
-    sourceRoot: sourceRoot ?? "",
+    sourceRoot,
     operations,
     warnings,
     hasLabelConflicts,
@@ -13990,7 +14018,7 @@ async function writeManifest(plan, sourceMeta, agentFiles, packageManager) {
     schemaVersion: 1,
     initializedAt: (/* @__PURE__ */ new Date()).toISOString(),
     pourkit: {
-      versionSource: "local-git",
+      versionSource: sourceMeta.versionSource,
       releaseVersion: sourceMeta.latestTag,
       releaseChannel: sourceMeta.releaseChannel,
       sourceBranch: sourceMeta.branch,
@@ -14185,7 +14213,7 @@ async function applyInitFromSource(options) {
   }
   let sourceMeta;
   try {
-    sourceMeta = await discoverLocalSource(fromLocal);
+    sourceMeta = await discoverLocalSource(plan.sourceRoot);
   } catch {
     sourceMeta = {
       versionSource: "local-path",
@@ -14231,7 +14259,6 @@ async function runInitCommand(options) {
   }
   if (!isInteractive && !options.yes && !options.dryRun) {
     const missing = [];
-    if (!options.fromLocal) missing.push("--from-local");
     if (!options.docsMigration) missing.push("--docs-migration");
     if (!options.agentFile) missing.push("--agent-file");
     if (!options.packageManager) {
@@ -14282,11 +14309,11 @@ async function runInitCommand(options) {
     };
     promptLabels = promptResult.labels;
   }
-  const conflictPolicy = options.fromLocal ? {
+  const conflictPolicy = {
     docsMigration: options.docsMigration ?? "copy",
     agentFile: options.agentFile ?? "both",
     yes: options.yes ?? false
-  } : void 0;
+  };
   const planLabels = isInteractive ? promptLabels ?? DEFAULT_RUNNER_LABELS : DEFAULT_RUNNER_LABELS;
   const plan = await planInit({
     targetRoot,
@@ -14341,12 +14368,6 @@ ${plan.warnings.length} warning(s) \u2014 review above before applying.`
     }
     return;
   }
-  if (!options.fromLocal) {
-    console.error(
-      "\nError: --from-local <path> is required to apply the init plan."
-    );
-    process.exit(1);
-  }
   const result = await applyInitFromSource({
     targetRoot,
     fromLocal: options.fromLocal,
@@ -14505,14 +14526,14 @@ async function runSerenaStatusCommand(options) {
 import { readFileSync as readFileSync20, existsSync as existsSync19 } from "fs";
 import { mkdir as mkdir6, readFile as readFile6, writeFile as writeFile3, readdir as readdir2 } from "fs/promises";
 import { resolve as resolve4, dirname as dirname5, relative as relative2 } from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
+import { fileURLToPath as fileURLToPath3 } from "url";
 import Ajv2 from "ajv";
-var __filename2 = fileURLToPath2(import.meta.url);
-var __dirname2 = dirname5(__filename2);
+var __filename3 = fileURLToPath3(import.meta.url);
+var __dirname3 = dirname5(__filename3);
 function resolvePackagedAssetPath2(fileName) {
   const candidates = [
-    resolve4(__dirname2, "schema", fileName),
-    resolve4(__dirname2, "../schema", fileName)
+    resolve4(__dirname3, "schema", fileName),
+    resolve4(__dirname3, "../schema", fileName)
   ];
   return candidates.find((candidate) => existsSync19(candidate)) ?? candidates[0];
 }
@@ -14544,7 +14565,7 @@ function localSchemaDir(repoRoot2) {
 var MANAGED_BLOCK_BEGIN2 = "<!-- BEGIN POURKIT MANAGED BLOCK -->\n";
 var OLD_DOCS_PATH_PATTERN = ".pourkit/docs/agents/";
 function resolvePackagedManagedPath(...segments) {
-  return resolve4(__dirname2, "..", "managed", ...segments);
+  return resolve4(__dirname3, "..", "managed", ...segments);
 }
 function resolvePackagedManagedDocPath(docName) {
   return resolvePackagedManagedPath("docs", "agents", docName);
@@ -15211,9 +15232,9 @@ async function runConfigSyncSchemaCommand(options) {
 import { existsSync as existsSync20, readdirSync as readdirSync5 } from "fs";
 import { mkdir as mkdir7, readFile as readFile7, writeFile as writeFile4, readdir as readdir3 } from "fs/promises";
 import { resolve as resolve5, dirname as dirname6, relative as relative3, normalize as normalize2 } from "path";
-import { fileURLToPath as fileURLToPath3 } from "url";
-var __filename3 = fileURLToPath3(import.meta.url);
-var __dirname3 = dirname6(__filename3);
+import { fileURLToPath as fileURLToPath4 } from "url";
+var __filename4 = fileURLToPath4(import.meta.url);
+var __dirname4 = dirname6(__filename4);
 var PROJECT_OWNED_PATHS = [".pourkit/CONTEXT.md", ".pourkit/CONTEXT-MAP.md"];
 var PROJECT_OWNED_DIRECTORIES = [
   ".pourkit/docs/adr",
@@ -15224,7 +15245,7 @@ var OVERRIDES_DIR = ".pourkit/overrides";
 var MANAGED_BLOCK_BEGIN3 = "<!-- BEGIN POURKIT MANAGED BLOCK -->\n";
 var MANAGED_BLOCK_END2 = "\n<!-- END POURKIT MANAGED BLOCK -->";
 function resolvePackagedManagedPath2(...segments) {
-  const candidates = [resolve5(__dirname3, "..", "managed", ...segments)];
+  const candidates = [resolve5(__dirname4, "..", "managed", ...segments)];
   return candidates[0];
 }
 function resolvePackagedManagedDocPath2(docName) {
@@ -15321,16 +15342,31 @@ function generateManagedBlockContent() {
   return [
     "This repository uses Pourkit.",
     "",
-    "## Managed operating docs",
+    "## Pourkit Workflow Routes",
+    "",
+    "### Issue Tracker",
+    "",
+    "When using Pourkit issue workflows, see `.pourkit/managed/docs/agents/issue-tracker.md`.",
+    "",
+    "### Triage Labels",
+    "",
+    "Pourkit workflows use the default triage labels described in `.pourkit/managed/docs/agents/triage-labels.md`.",
+    "",
+    "### Domain Docs",
+    "",
+    "Follow the repository domain-documentation layout in `.pourkit/managed/docs/agents/domain.md`.",
+    "",
+    "### Issue Naming",
+    "",
+    "PRDs and child issues must follow the naming convention in `.pourkit/managed/docs/agents/naming.md`.",
+    "",
+    "### Git Workflow",
+    "",
+    "Branch naming and PR creation guidance lives in `.pourkit/managed/docs/agents/git-workflow.md`.",
     "",
-    "Follow the managed operating docs under `.pourkit/managed/docs/agents/*`:",
+    "### Commit Style",
     "",
-    "- `.pourkit/managed/docs/agents/issue-tracker.md`",
-    "- `.pourkit/managed/docs/agents/triage-labels.md`",
-    "- `.pourkit/managed/docs/agents/naming.md`",
-    "- `.pourkit/managed/docs/agents/git-workflow.md`",
-    "- `.pourkit/managed/docs/agents/commit-style.md`",
-    "- `.pourkit/managed/docs/agents/domain.md`",
+    "Agents must write readable conventional commits with bullet-list bodies for non-trivial changes. See `.pourkit/managed/docs/agents/commit-style.md`.",
     "",
     "### Project-owned context",
     "",
@@ -17193,7 +17229,10 @@ function createCliProgram(version) {
     const result = runPrdRunListCommand({ repoRoot: targetRepoRoot });
     console.log(JSON.stringify(result, null, 2));
   });
-  program.command("init").description("Initialize .pourkit layout in a target repo").option("--dry-run", "print the init plan without applying changes").option("--json", "output machine-readable JSON plan").option("--from-local <path>", "local source repo to copy artifacts from").option("--cwd <path>", "target repository directory").addOption(
+  program.command("init").description("Initialize .pourkit layout in a target repo").option("--dry-run", "print the init plan without applying changes").option("--json", "output machine-readable JSON plan").option(
+    "--from-local <path>",
+    "deprecated: local source repo to copy artifacts from"
+  ).option("--cwd <path>", "target repository directory").addOption(
     new Option(
       "--docs-migration <mode>",
       "docs migration mode: copy, move, skip"
@@ -17392,11 +17431,11 @@ function createCliProgram(version) {
   return program;
 }
 async function resolveCliVersion() {
-  if (isPackageVersion("0.0.0-next-20260617183635")) {
-    return "0.0.0-next-20260617183635";
+  if (isPackageVersion("0.0.0-next-20260617220545")) {
+    return "0.0.0-next-20260617220545";
   }
-  if (isReleaseVersion("0.0.0-next-20260617183635")) {
-    return "0.0.0-next-20260617183635";
+  if (isReleaseVersion("0.0.0-next-20260617220545")) {
+    return "0.0.0-next-20260617220545";
   }
   try {
     const root = repoRoot();