npm - @agent-native/core - Versions diffs - 0.109.2 → 0.109.4 - Mend

@agent-native/core 0.109.2 → 0.109.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (334) hide show

package/dist/cli/package-lifecycle.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"package-lifecycle.d.ts","sourceRoot":"","sources":["../../src/cli/package-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAK/C,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,kCAAkC,CAAC;AAE1C,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,kBAAkB,CAAC;IACxB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC7E,KAAK,CAAC,EAAE,OAAO,SAAS,CAAC;CAC1B;AAED,UAAU,MAAM;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrC,IAAI,EACA,YAAY,GACZ,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,YAAY,GACZ,OAAO,GACP,WAAW,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,GAAG,eAAe,GAAG,gBAAgB,CAAC;IAC1D,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE;QACb,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,kBAAkB,EAAE,MAAM,EAAE,CAAC;QAC7B,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACxC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAOD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,MAAM,CAAC,CAqDjB;AAaD,wBAAgB,qBAAqB,IAAI,MAAM,~~CAS9C~~;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,GAAE,OAAO,SAAqB,GAClC,OAAO,CAAC,sBAAsB,CAAC,CAkFjC"}
1	+ {"version":3,"file":"package-lifecycle.d.ts","sourceRoot":"","sources":["../../src/cli/package-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAK/C,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,kCAAkC,CAAC;AAE1C,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,kBAAkB,CAAC;IACxB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC7E,KAAK,CAAC,EAAE,OAAO,SAAS,CAAC;CAC1B;AAED,UAAU,MAAM;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrC,IAAI,EACA,YAAY,GACZ,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,YAAY,GACZ,OAAO,GACP,WAAW,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,GAAG,eAAe,GAAG,gBAAgB,CAAC;IAC1D,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE;QACb,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,kBAAkB,EAAE,MAAM,EAAE,CAAC;QAC7B,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACxC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAOD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,MAAM,CAAC,CAqDjB;AAaD,wBAAgB,qBAAqB,IAAI,MAAM,CAW9C;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,GAAE,OAAO,SAAqB,GAClC,OAAO,CAAC,sBAAsB,CAAC,CAkFjC"}

package/dist/cli/package-lifecycle.js CHANGED Viewed

@@ -66,6 +66,8 @@ function flagValue(args, name) {
 }
 export function packageLifecycleUsage() {
     return [
+        "Install-on-demand Toolkit capability module lifecycle:",
+        "",
         "Usage:",
         "  agent-native package inspect <package> [--root <dir>] [--app <name>] [--json]",
         "  agent-native package add <package> [--root <dir>] [--app <name>] [--apply] [--json]",

package/dist/cli/package-lifecycle.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"package-lifecycle.js","sourceRoot":"","sources":["../../src/cli/package-lifecycle.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawnSync } from \"node:child_process\";\nimport fs from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\n\nimport {\n assertAgentNativePackageManifest,\n type AgentNativePackageManifest,\n} from \"../package-lifecycle/manifest.js\";\n\nexport interface PackageLifecycleIO {\n out(message: string): void;\n err(message: string): void;\n}\n\nexport interface LoadedLifecyclePackage {\n manifest: AgentNativePackageManifest;\n packageVersion: string;\n packageDir: string;\n packageJson: Record<string, unknown>;\n cleanup?: () => void;\n}\n\nexport interface PackageLifecycleRuntime {\n cwd?: string;\n io?: PackageLifecycleIO;\n loadPackage?: (name: string, cwd: string) => Promise<LoadedLifecyclePackage>;\n spawn?: typeof spawnSync;\n}\n\ninterface Change {\n path: string;\n action: \"create\" \| \"update\" \| \"noop\";\n kind:\n \| \"dependency\"\n \| \"action\"\n \| \"schema\"\n \| \"skill\"\n \| \"provenance\"\n \| \"eject\"\n \| \"workspace\";\n content?: string \| Buffer;\n}\n\nexport interface PackageLifecycleReport {\n command: \"inspect\" \| \"add\" \| \"eject\";\n package: string;\n packageVersion: string;\n manifestVersion: number;\n targetRoot: string;\n layout: \"standalone\" \| \"workspace-app\" \| \"workspace-root\";\n apply: boolean;\n compatible: boolean;\n contributions: {\n actions: string[];\n schemaEntryPoint: string;\n skills: string[];\n requiredSecretKeys: string[];\n peerProviders: string[];\n };\n changes: Array<Omit<Change, \"content\">>;\n collisions: string[];\n warnings: string[];\n}\n\nconst defaultIO: PackageLifecycleIO = {\n out: (message) => console.log(message),\n err: (message) => console.error(message),\n};\n\nexport async function runPackageLifecycle(\n args: string[],\n runtime: PackageLifecycleRuntime = {},\n): Promise<number> {\n const io = runtime.io ?? defaultIO;\n const command = args[0];\n const packageName = args[1];\n if (!isCommand(command) \|\| !packageName) {\n io.err(packageLifecycleUsage());\n return 1;\n }\n const json = args.includes(\"--json\");\n const apply = args.includes(\"--apply\");\n if (apply && command === \"inspect\") {\n io.err(\"package inspect is always read-only; remove --apply\");\n return 1;\n }\n const cwd = path.resolve(\n flagValue(args, \"--root\") ?? runtime.cwd ?? process.cwd(),\n );\n let loaded: LoadedLifecyclePackage \| undefined;\n try {\n loaded = await (runtime.loadPackage\n ? runtime.loadPackage(packageName, cwd)\n : loadLifecyclePackage(packageName, cwd, runtime.spawn ?? spawnSync));\n if (loaded.manifest.name !== packageName) {\n throw new Error(\n `Manifest name ${loaded.manifest.name} does not match requested package ${packageName}`,\n );\n }\n const target = resolveTarget(cwd, flagValue(args, \"--app\"));\n const planned =\n command === \"eject\"\n ? planEject(loaded, target.root, target.layout)\n : planAdd(loaded, target.root, target.layout, command === \"inspect\");\n const report = reportFor(command, loaded, target, apply, planned);\n if (report.collisions.length > 0) {\n report.compatible = false;\n }\n if (json) io.out(JSON.stringify(report, null, 2));\n else io.out(formatReport(report));\n if (!report.compatible) return 1;\n if (command === \"inspect\" \|\| !apply) return 0;\n\n await applyTransaction(\n target.root,\n planned.changes.filter((change) => change.action !== \"noop\"),\n runtime.spawn ?? spawnSync,\n );\n return 0;\n } catch (error) {\n io.err(error instanceof Error ? error.message : String(error));\n return 1;\n } finally {\n loaded?.cleanup?.();\n }\n}\n\nfunction isCommand(\n value: string \| undefined,\n): value is \"inspect\" \| \"add\" \| \"eject\" {\n return value === \"inspect\" \|\| value === \"add\" \|\| value === \"eject\";\n}\n\nfunction flagValue(args: string[], name: string): string \| undefined {\n const index = args.indexOf(name);\n return index >= 0 ? args[index + 1] : undefined;\n}\n\nexport function packageLifecycleUsage(): string {\n return [\n \"Usage:\",\n \" agent-native package inspect <package> [--root <dir>] [--app <name>] [--json]\",\n \" agent-native package add <package> [--root <dir>] [--app <name>] [--apply] [--json]\",\n \" agent-native package eject <package> [--root <dir>] [--app <name>] [--apply] [--json]\",\n \"\",\n \"add and eject are dry-run by default; pass --apply to write and run the package manager.\",\n ].join(\"\\n\");\n}\n\nexport async function loadLifecyclePackage(\n name: string,\n cwd: string,\n spawn: typeof spawnSync = spawnSync,\n): Promise<LoadedLifecyclePackage> {\n const packageJsonPath = findInstalledPackageJson(name, cwd);\n if (packageJsonPath) {\n return loadStaticPackageDirectory(name, path.dirname(packageJsonPath));\n }\n if (!/^(@[a-z0-9._-]+\\/)?[a-z0-9._-]+$/.test(name)) {\n throw new Error(`Invalid package name: ${name}`);\n }\n const stage = fs.mkdtempSync(\n path.join(os.tmpdir(), \"agent-native-package-inspect-\"),\n );\n try {\n const packed = spawn(\n \"npm\",\n [\"pack\", name, \"--ignore-scripts\", \"--json\", \"--pack-destination\", stage],\n { cwd, encoding: \"utf8\", stdio: \"pipe\" },\n );\n if (packed.status !== 0) {\n throw new Error(`Unable to download package metadata for '${name}'`);\n }\n const entries = JSON.parse(String(packed.stdout \|\| \"[]\")) as Array<{\n filename?: string;\n }>;\n const filename = entries[0]?.filename;\n if (!filename \|\| path.basename(filename) !== filename) {\n throw new Error(\n `npm pack returned an invalid archive name for '${name}'`,\n );\n }\n const archive = path.join(stage, filename);\n const listed = spawn(\"tar\", [\"-tzf\", archive], {\n cwd,\n encoding: \"utf8\",\n stdio: \"pipe\",\n });\n if (listed.status !== 0) {\n throw new Error(`Unable to list package archive for '${name}'`);\n }\n const archiveEntries = String(listed.stdout \|\| \"\")\n .split(/\\r?\\n/)\n .filter(Boolean);\n if (\n archiveEntries.length === 0 \|\|\n archiveEntries.some(\n (entry) =>\n entry.includes(\"\\\\\") \|\|\n entry.startsWith(\"/\") \|\|\n !entry.startsWith(\"package/\") \|\|\n entry.split(\"/\").includes(\"..\"),\n )\n ) {\n throw new Error(`Package archive for '${name}' contains an unsafe path`);\n }\n const extracted = spawn(\n \"tar\",\n [\n \"-xzf\",\n archive,\n \"-C\",\n stage,\n \"--no-same-owner\",\n \"--no-same-permissions\",\n ],\n {\n cwd,\n encoding: \"utf8\",\n stdio: \"pipe\",\n },\n );\n if (extracted.status !== 0) {\n throw new Error(`Unable to inspect package archive for '${name}'`);\n }\n const loaded = loadStaticPackageDirectory(\n name,\n path.join(stage, \"package\"),\n );\n loaded.cleanup = () => fs.rmSync(stage, { recursive: true, force: true });\n return loaded;\n } catch (error) {\n fs.rmSync(stage, { recursive: true, force: true });\n throw error;\n }\n}\n\nfunction loadStaticPackageDirectory(\n name: string,\n packageDir: string,\n): LoadedLifecyclePackage {\n const packageJsonPath = path.join(packageDir, \"package.json\");\n const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, \"utf8\")) as {\n name?: string;\n version?: string;\n agentNativeManifest?: string;\n [key: string]: unknown;\n };\n if (packageJson.name !== name) {\n throw new Error(\n `Installed package name ${String(packageJson.name)} does not match ${name}`,\n );\n }\n if (!packageJson.version) {\n throw new Error(`Package '${name}' has no version`);\n }\n if (\n !/^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$/.test(\n packageJson.version,\n )\n ) {\n throw new Error(`Package '${name}' has an invalid version`);\n }\n const relativeManifest = packageJson.agentNativeManifest;\n if (!relativeManifest \|\| path.isAbsolute(relativeManifest)) {\n throw new Error(\n `Package '${name}' does not declare a static agentNativeManifest`,\n );\n }\n const manifestPath = path.resolve(packageDir, relativeManifest);\n if (\n manifestPath !== packageDir &&\n !manifestPath.startsWith(`${path.resolve(packageDir)}${path.sep}`)\n ) {\n throw new Error(`Package '${name}' manifest escapes the package directory`);\n }\n const manifestStat = fs.lstatSync(manifestPath);\n if (!manifestStat.isFile() \|\| manifestStat.isSymbolicLink()) {\n throw new Error(`Package '${name}' static manifest must be a regular file`);\n }\n const realPackageDir = fs.realpathSync(packageDir);\n const realManifestPath = fs.realpathSync(manifestPath);\n if (!realManifestPath.startsWith(`${realPackageDir}${path.sep}`)) {\n throw new Error(\n `Package '${name}' static manifest escapes the package directory`,\n );\n }\n const manifest = JSON.parse(fs.readFileSync(manifestPath, \"utf8\"));\n assertAgentNativePackageManifest(manifest);\n if (manifest.name !== name) {\n throw new Error(`Manifest name ${manifest.name} does not match ${name}`);\n }\n return {\n manifest,\n packageVersion: packageJson.version,\n packageDir,\n packageJson,\n };\n}\n\nfunction findInstalledPackageJson(name: string, from: string): string \| null {\n let dir = from;\n while (true) {\n const candidate = path.join(dir, \"node_modules\", name, \"package.json\");\n if (fs.existsSync(candidate)) return candidate;\n const parent = path.dirname(dir);\n if (parent === dir) return null;\n dir = parent;\n }\n}\n\nfunction resolveTarget(\n root: string,\n appName?: string,\n): { root: string; layout: PackageLifecycleReport[\"layout\"] } {\n const packageJsonPath = path.join(root, \"package.json\");\n if (!fs.existsSync(packageJsonPath)) {\n throw new Error(`Target root has no package.json: ${root}`);\n }\n const pkg = JSON.parse(fs.readFileSync(packageJsonPath, \"utf8\"));\n const workspace =\n typeof pkg?.[\"agent-native\"]?.workspaceCore === \"string\" &&\n fs.existsSync(path.join(root, \"apps\"));\n if (!workspace) return { root, layout: \"standalone\" };\n if (!appName) {\n return { root, layout: \"workspace-root\" };\n }\n if (!/^[a-z0-9][a-z0-9-]$/.test(appName)) {\n throw new Error(`Invalid workspace app name: ${appName}`);\n }\n const appRoot = path.join(root, \"apps\", appName);\n if (!fs.existsSync(path.join(appRoot, \"package.json\"))) {\n throw new Error(`Workspace app not found: ${appRoot}`);\n }\n return { root: appRoot, layout: \"workspace-app\" };\n}\n\nfunction planAdd(\n loaded: LoadedLifecyclePackage,\n targetRoot: string,\n layout: PackageLifecycleReport[\"layout\"],\n inspectOnly: boolean,\n): { changes: Change[]; collisions: string[]; warnings: string[] } {\n const { manifest, packageDir } = loaded;\n const collisions: string[] = [];\n const warnings: string[] = [];\n if (layout === \"workspace-root\") {\n collisions.push(\"Workspace root is ambiguous; pass --app <name> for add\");\n return { changes: [], collisions, warnings };\n }\n const packageJsonPath = path.join(targetRoot, \"package.json\");\n const pkg = JSON.parse(fs.readFileSync(packageJsonPath, \"utf8\"));\n pkg.dependencies ??= {};\n const wantedRange = `^${loaded.packageVersion}`;\n const currentRange = pkg.dependencies[manifest.name];\n if (currentRange !== wantedRange && currentRange !== \"workspace:\") {\n pkg.dependencies[manifest.name] = wantedRange;\n }\n const changes: Change[] = [\n textChange(\n targetRoot,\n packageJsonPath,\n `${JSON.stringify(pkg, null, 2)}\\n`,\n \"dependency\",\n ),\n ];\n for (const action of manifest.actions) {\n const target = path.join(targetRoot, \"actions\", `${action}.ts`);\n const content = `export { default } from \"${manifest.name}/actions/${action}\";\\n`;\n changes.push(\n collisionCheckedText(targetRoot, target, content, \"action\", collisions),\n );\n }\n\n const schemaPath = path.join(targetRoot, \"server\", \"db\", \"schema.ts\");\n if (!fs.existsSync(schemaPath)) {\n collisions.push(\n `Required schema file is missing: ${relative(targetRoot, schemaPath)}`,\n );\n } else {\n const current = fs.readFileSync(schemaPath, \"utf8\");\n const marker = `// agent-native-package:${manifest.name}`;\n const contribution = `${marker}\\nexport * from \"${manifest.schemaEntryPoint}\";`;\n if (current.includes(marker) && !current.includes(contribution)) {\n collisions.push(\n \"Existing package-owned schema block has unexpected content\",\n );\n }\n const next = current.includes(contribution)\n ? current\n : `${current.trimEnd()}\\n\\n${contribution}\\n`;\n changes.push(textChange(targetRoot, schemaPath, next, \"schema\"));\n }\n\n const ownedPaths: string[] = [];\n for (const skill of manifest.docs.skills) {\n const source = path.join(packageDir, \"docs\", \"skills\", skill);\n if (!fs.existsSync(source)) {\n collisions.push(`Manifest skill source is missing: docs/skills/${skill}`);\n continue;\n }\n for (const sourceFile of walkFiles(source)) {\n const target = path.join(\n targetRoot,\n \".agents\",\n \"skills\",\n skill,\n path.relative(source, sourceFile),\n );\n changes.push(\n collisionCheckedBuffer(\n targetRoot,\n target,\n fs.readFileSync(sourceFile),\n \"skill\",\n collisions,\n ),\n );\n ownedPaths.push(relative(targetRoot, target));\n }\n }\n const provenancePath = path.join(\n targetRoot,\n \".agent-native\",\n \"packages\",\n `${manifest.name.replaceAll(\"/\", \"__\")}.json`,\n );\n const provenance = {\n manifestVersion: manifest.manifestVersion,\n package: manifest.name,\n version: loaded.packageVersion,\n actions: manifest.actions,\n schemaEntryPoint: manifest.schemaEntryPoint,\n skills: manifest.docs.skills,\n files: ownedPaths.sort(),\n };\n changes.push(\n textChange(\n targetRoot,\n provenancePath,\n `${JSON.stringify(provenance, null, 2)}\\n`,\n \"provenance\",\n ),\n );\n if (inspectOnly)\n warnings.push(\"inspect is read-only; shown changes are the add plan\");\n return { changes, collisions, warnings };\n}\n\nfunction planEject(\n loaded: LoadedLifecyclePackage,\n targetRoot: string,\n layout: PackageLifecycleReport[\"layout\"],\n): { changes: Change[]; collisions: string[]; warnings: string[] } {\n const collisions: string[] = [];\n const warnings: string[] = [];\n if (loaded.manifest.name !== \"@agent-native/scheduling\") {\n collisions.push(\"Eject currently supports only @agent-native/scheduling\");\n return { changes: [], collisions, warnings };\n }\n if (!loaded.manifest.eject) {\n collisions.push(\"Package manifest does not declare eject metadata\");\n return { changes: [], collisions, warnings };\n }\n const workspaceRoot =\n layout === \"workspace-app\" ? path.resolve(targetRoot, \"../..\") : targetRoot;\n const pnpmWorkspace = path.join(workspaceRoot, \"pnpm-workspace.yaml\");\n if (!fs.existsSync(pnpmWorkspace)) {\n collisions.push(\n \"Eject currently requires an existing pnpm workspace; refusing to create a workspace:* dependency for another package manager\",\n );\n return { changes: [], collisions, warnings };\n }\n const targetDir = path.join(\n workspaceRoot,\n loaded.manifest.eject.targetDirectory,\n );\n if (fs.existsSync(targetDir)) {\n collisions.push(\n `Eject target already exists: ${relative(workspaceRoot, targetDir)}`,\n );\n return { changes: [], collisions, warnings };\n }\n const sourceRoot = path.join(\n loaded.packageDir,\n loaded.manifest.eject.sourceRoot,\n );\n if (!fs.existsSync(sourceRoot)) {\n collisions.push(\n `Published eject source is missing: ${loaded.manifest.eject.sourceRoot}`,\n );\n return { changes: [], collisions, warnings };\n }\n const changes: Change[] = [];\n for (const source of walkFiles(sourceRoot)) {\n const target = path.join(\n targetDir,\n \"src\",\n path.relative(sourceRoot, source),\n );\n changes.push({\n path: target,\n action: \"create\",\n kind: \"eject\",\n content: fs.readFileSync(source),\n });\n }\n for (const name of [\"tsconfig.json\", \"agent-native.package.json\"]) {\n const source = path.join(loaded.packageDir, name);\n if (fs.existsSync(source)) {\n changes.push({\n path: path.join(targetDir, name),\n action: \"create\",\n kind: \"eject\",\n content: fs.readFileSync(source),\n });\n }\n }\n changes.push({\n path: path.join(targetDir, \"package.json\"),\n action: \"create\",\n kind: \"eject\",\n content: `${JSON.stringify(\n normalizeEjectedPackageJson(loaded.packageJson, workspaceRoot),\n null,\n 2,\n )}\\n`,\n });\n const consumerPackageJson = path.join(targetRoot, \"package.json\");\n const consumer = JSON.parse(fs.readFileSync(consumerPackageJson, \"utf8\"));\n consumer.dependencies ??= {};\n consumer.dependencies[loaded.manifest.name] = \"workspace:\";\n changes.push(\n textChange(\n workspaceRoot,\n consumerPackageJson,\n `${JSON.stringify(consumer, null, 2)}\\n`,\n \"dependency\",\n ),\n );\n if (fs.existsSync(pnpmWorkspace)) {\n const text = fs.readFileSync(pnpmWorkspace, \"utf8\");\n if (!text.includes(\"packages/\") && !text.includes(\"packages/*\")) {\n collisions.push(\n \"pnpm-workspace.yaml does not include packages/; refusing to rewrite YAML\",\n );\n }\n } else {\n changes.push({\n path: pnpmWorkspace,\n action: \"create\",\n kind: \"workspace\",\n content: 'packages:\\n - \"packages/*\"\\n',\n });\n }\n warnings.push(\n \"Imports keep the canonical @agent-native/scheduling specifier; workspace resolution switches them to the local package.\",\n );\n return { changes, collisions, warnings };\n}\n\nfunction normalizeEjectedPackageJson(\n input: Record<string, unknown>,\n workspaceRoot: string,\n): Record<string, unknown> {\n const output = structuredClone(input) as Record<string, any>;\n for (const field of [\"dependencies\", \"devDependencies\", \"peerDependencies\"]) {\n const dependencies = output[field] as Record<string, unknown> \| undefined;\n if (!dependencies) continue;\n for (const [name, range] of Object.entries(dependencies)) {\n if (\n typeof range !== \"string\" \|\|\n (!range.startsWith(\"workspace:\") && !range.startsWith(\"catalog:\"))\n ) {\n continue;\n }\n const installed = findInstalledPackageJson(name, workspaceRoot);\n if (!installed) {\n throw new Error(\n `Cannot normalize ${field}.${name}; the installed dependency version is unavailable`,\n );\n }\n const version = JSON.parse(fs.readFileSync(installed, \"utf8\")).version;\n if (!version)\n throw new Error(`Installed dependency ${name} has no version`);\n dependencies[name] = `^${version}`;\n }\n }\n return output;\n}\n\nfunction collisionCheckedText(\n root: string,\n target: string,\n content: string,\n kind: Change[\"kind\"],\n collisions: string[],\n): Change {\n return collisionCheckedBuffer(\n root,\n target,\n Buffer.from(content),\n kind,\n collisions,\n );\n}\n\nfunction collisionCheckedBuffer(\n root: string,\n target: string,\n content: Buffer,\n kind: Change[\"kind\"],\n collisions: string[],\n): Change {\n if (!fs.existsSync(target)) {\n return { path: target, action: \"create\", kind, content };\n }\n const current = fs.readFileSync(target);\n if (current.equals(content)) return { path: target, action: \"noop\", kind };\n collisions.push(`Refusing to overwrite ${relative(root, target)}`);\n return { path: target, action: \"noop\", kind };\n}\n\nfunction textChange(\n root: string,\n target: string,\n content: string,\n kind: Change[\"kind\"],\n): Change {\n if (!fs.existsSync(target))\n return { path: target, action: \"create\", kind, content };\n return {\n path: target,\n action: fs.readFileSync(target, \"utf8\") === content ? \"noop\" : \"update\",\n kind,\n content,\n };\n}\n\nfunction walkFiles(root: string): string[] {\n const files: string[] = [];\n for (const entry of fs.readdirSync(root, { withFileTypes: true })) {\n const full = path.join(root, entry.name);\n if (entry.isSymbolicLink())\n throw new Error(`Refusing package symlink: ${full}`);\n if (entry.isDirectory()) files.push(...walkFiles(full));\n else if (entry.isFile()) files.push(full);\n }\n return files.sort();\n}\n\nfunction reportFor(\n command: PackageLifecycleReport[\"command\"],\n loaded: LoadedLifecyclePackage,\n target: { root: string; layout: PackageLifecycleReport[\"layout\"] },\n apply: boolean,\n planned: { changes: Change[]; collisions: string[]; warnings: string[] },\n): PackageLifecycleReport {\n const { manifest } = loaded;\n return {\n command,\n package: manifest.name,\n packageVersion: loaded.packageVersion,\n manifestVersion: manifest.manifestVersion,\n targetRoot: target.root,\n layout: target.layout,\n apply,\n compatible: planned.collisions.length === 0,\n contributions: {\n actions: manifest.actions,\n schemaEntryPoint: manifest.schemaEntryPoint,\n skills: manifest.docs.skills,\n requiredSecretKeys: manifest.requiredSecrets.map((secret) => secret.key),\n peerProviders: manifest.peerProviders,\n },\n changes: planned.changes.map(({ path: file, action, kind }) => ({\n path: relative(target.root, file),\n action,\n kind,\n })),\n collisions: planned.collisions,\n warnings: planned.warnings,\n };\n}\n\nfunction formatReport(report: PackageLifecycleReport): string {\n const lines = [\n `# ${report.command} ${report.package}@${report.packageVersion}`,\n `Manifest: v${report.manifestVersion}`,\n `Target: ${report.targetRoot} (${report.layout})`,\n `Mode: ${report.apply ? \"apply\" : \"dry-run\"}`,\n `Compatible: ${report.compatible ? \"yes\" : \"no\"}`,\n \"\",\n `Actions: ${report.contributions.actions.length}`,\n `Schema: ${report.contributions.schemaEntryPoint}`,\n `Skills: ${report.contributions.skills.join(\", \") \|\| \"none\"}`,\n `Required secret keys: ${report.contributions.requiredSecretKeys.join(\", \") \|\| \"none\"}`,\n `Peer providers: ${report.contributions.peerProviders.join(\", \") \|\| \"none\"}`,\n \"\",\n \"Changes:\",\n ...report.changes.map(\n (change) =>\n ` ${change.action.padEnd(6)} ${change.path} (${change.kind})`,\n ),\n ];\n if (report.collisions.length) {\n lines.push(\n \"\",\n \"Collisions:\",\n ...report.collisions.map((item) => ` - ${item}`),\n );\n }\n if (report.warnings.length) {\n lines.push(\"\", \"Notes:\", ...report.warnings.map((item) => ` - ${item}`));\n }\n if (!report.apply && report.command !== \"inspect\") {\n lines.push(\"\", \"Dry-run only. Re-run with --apply to write these changes.\");\n }\n return lines.join(\"\\n\");\n}\n\nasync function applyTransaction(\n root: string,\n changes: Change[],\n spawn: typeof spawnSync,\n): Promise<void> {\n const stage = fs.mkdtempSync(path.join(root, \".agent-native-package-stage-\"));\n const snapshots = new Map<string, Buffer \| null>();\n const installRoot = findPackageManagerRoot(root);\n const lockfiles = [\"pnpm-lock.yaml\", \"package-lock.json\", \"yarn.lock\"].map(\n (name) => path.join(installRoot, name),\n );\n try {\n for (const change of changes) {\n snapshots.set(\n change.path,\n fs.existsSync(change.path) ? fs.readFileSync(change.path) : null,\n );\n const staged = path.join(stage, String(snapshots.size));\n fs.writeFileSync(staged, change.content!);\n }\n for (const lockfile of lockfiles) {\n snapshots.set(\n lockfile,\n fs.existsSync(lockfile) ? fs.readFileSync(lockfile) : null,\n );\n }\n let index = 0;\n for (const change of changes) {\n index += 1;\n fs.mkdirSync(path.dirname(change.path), { recursive: true });\n fs.renameSync(path.join(stage, String(index)), change.path);\n }\n const packageManager = detectPackageManager(installRoot);\n const result = spawn(packageManager, [\"install\"], {\n cwd: installRoot,\n stdio: \"inherit\",\n });\n if (result.status !== 0) {\n throw new Error(\n `${packageManager} install failed with status ${result.status}`,\n );\n }\n } catch (error) {\n for (const [file, snapshot] of [...snapshots.entries()].reverse()) {\n if (snapshot === null) fs.rmSync(file, { force: true, recursive: true });\n else {\n fs.mkdirSync(path.dirname(file), { recursive: true });\n fs.writeFileSync(file, snapshot);\n }\n }\n for (const change of [...changes].reverse()) {\n removeEmptyParents(path.dirname(change.path), root);\n }\n throw error;\n } finally {\n fs.rmSync(stage, { recursive: true, force: true });\n }\n}\n\nfunction removeEmptyParents(directory: string, stop: string): void {\n let current = directory;\n const boundary = path.resolve(stop);\n while (current.startsWith(`${boundary}${path.sep}`)) {\n try {\n if (fs.readdirSync(current).length > 0) return;\n fs.rmdirSync(current);\n } catch {\n return;\n }\n current = path.dirname(current);\n }\n}\n\nfunction detectPackageManager(root: string): \"pnpm\" \| \"yarn\" \| \"npm\" {\n if (fs.existsSync(path.join(root, \"pnpm-lock.yaml\"))) return \"pnpm\";\n if (fs.existsSync(path.join(root, \"yarn.lock\"))) return \"yarn\";\n return \"npm\";\n}\n\nfunction findPackageManagerRoot(from: string): string {\n let dir = from;\n while (true) {\n if (\n fs.existsSync(path.join(dir, \"pnpm-lock.yaml\")) \|\|\n fs.existsSync(path.join(dir, \"yarn.lock\")) \|\|\n fs.existsSync(path.join(dir, \"package-lock.json\"))\n ) {\n return dir;\n }\n const parent = path.dirname(dir);\n if (parent === dir) return from;\n dir = parent;\n }\n}\n\nfunction relative(root: string, file: string): string {\n const value = path.relative(root, file);\n return value \|\| \".\";\n}\n"]}
1	+ {"version":3,"file":"package-lifecycle.js","sourceRoot":"","sources":["../../src/cli/package-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EACL,gCAAgC,GAEjC,MAAM,kCAAkC,CAAC;AAyD1C,MAAM,SAAS,GAAuB;IACpC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;IACtC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;CACzC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAc,EACd,OAAO,GAA4B,EAAE;IAErC,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,SAAS,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACxC,EAAE,CAAC,GAAG,CAAC,qBAAqB,EAAE,CAAC,CAAC;QAChC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,KAAK,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACnC,EAAE,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;QAC9D,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CACtB,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAC1D,CAAC;IACF,IAAI,MAA0C,CAAC;IAC/C,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW;YACjC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,GAAG,CAAC;YACvC,CAAC,CAAC,oBAAoB,CAAC,WAAW,EAAE,GAAG,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC;QACxE,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CACb,iBAAiB,MAAM,CAAC,QAAQ,CAAC,IAAI,qCAAqC,WAAW,EAAE,CACxF,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QAC5D,MAAM,OAAO,GACX,OAAO,KAAK,OAAO;YACjB,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;YAC/C,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAClE,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC;QAC5B,CAAC;QACD,IAAI,IAAI;YAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;;YAC7C,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO,CAAC,CAAC;QACjC,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,CAAC;QAE9C,MAAM,gBAAgB,CACpB,MAAM,CAAC,IAAI,EACX,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,EAC5D,OAAO,CAAC,KAAK,IAAI,SAAS,CAC3B,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,EAAE,CAAC,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/D,OAAO,CAAC,CAAC;IACX,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC;IACtB,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAChB,KAAyB;IAEzB,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,OAAO,CAAC;AACrE,CAAC;AAED,SAAS,SAAS,CAAC,IAAc,EAAE,IAAY;IAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,wDAAwD;QACxD,EAAE;QACF,QAAQ;QACR,iFAAiF;QACjF,uFAAuF;QACvF,yFAAyF;QACzF,EAAE;QACF,0FAA0F;KAC3F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAY,EACZ,GAAW,EACX,KAAK,GAAqB,SAAS;IAEnC,MAAM,eAAe,GAAG,wBAAwB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC5D,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,0BAA0B,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,CAAC,kCAAkC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAC1B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,+BAA+B,CAAC,CACxD,CAAC;IACF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,KAAK,CAClB,KAAK,EACL,CAAC,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,CAAC,EACzE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CACzC,CAAC;QACF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,GAAG,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,CAEtD,CAAC;QACH,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC;QACtC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,QAAQ,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CACb,kDAAkD,IAAI,GAAG,CAC1D,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;YAC7C,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,GAAG,CAAC,CAAC;QAClE,CAAC;QACD,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;aAC/C,KAAK,CAAC,OAAO,CAAC;aACd,MAAM,CAAC,OAAO,CAAC,CAAC;QACnB,IACE,cAAc,CAAC,MAAM,KAAK,CAAC;YAC3B,cAAc,CAAC,IAAI,CACjB,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACpB,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;gBACrB,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC;gBAC7B,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAClC,EACD,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,2BAA2B,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,SAAS,GAAG,KAAK,CACrB,KAAK,EACL;YACE,MAAM;YACN,OAAO;YACP,IAAI;YACJ,KAAK;YACL,iBAAiB;YACjB,uBAAuB;SACxB,EACD;YACE,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,MAAM;SACd,CACF,CAAC;QACF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,GAAG,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,MAAM,GAAG,0BAA0B,CACvC,IAAI,EACJ,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAC5B,CAAC;QACF,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1E,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,0BAA0B,CACjC,IAAY,EACZ,UAAkB;IAElB,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAC9D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAKtE,CAAC;IACF,IAAI,WAAW,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,0BAA0B,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB,IAAI,EAAE,CAC5E,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,kBAAkB,CAAC,CAAC;IACtD,CAAC;IACD,IACE,CAAC,0DAA0D,CAAC,IAAI,CAC9D,WAAW,CAAC,OAAO,CACpB,EACD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,0BAA0B,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,gBAAgB,GAAG,WAAW,CAAC,mBAAmB,CAAC;IACzD,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CACb,YAAY,IAAI,iDAAiD,CAClE,CAAC;IACJ,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IAChE,IACE,YAAY,KAAK,UAAU;QAC3B,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,EAClE,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,0CAA0C,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,YAAY,GAAG,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IAChD,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,YAAY,CAAC,cAAc,EAAE,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,0CAA0C,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,cAAc,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,gBAAgB,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IACvD,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,GAAG,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CACb,YAAY,IAAI,iDAAiD,CAClE,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IACnE,gCAAgC,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,CAAC,IAAI,mBAAmB,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO;QACL,QAAQ;QACR,cAAc,EAAE,WAAW,CAAC,OAAO;QACnC,UAAU;QACV,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,IAAY,EAAE,IAAY;IAC1D,IAAI,GAAG,GAAG,IAAI,CAAC;IACf,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACvE,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAChC,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CACpB,IAAY,EACZ,OAAgB;IAEhB,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IACxD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;IACjE,MAAM,SAAS,GACb,OAAO,GAAG,EAAE,CAAC,cAAc,CAAC,EAAE,aAAa,KAAK,QAAQ;QACxD,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IACtD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC5C,CAAC;IACD,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;AACpD,CAAC;AAED,SAAS,OAAO,CACd,MAA8B,EAC9B,UAAkB,EAClB,MAAwC,EACxC,WAAoB;IAEpB,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IACxC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,MAAM,KAAK,gBAAgB,EAAE,CAAC;QAChC,UAAU,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;QAC1E,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC/C,CAAC;IACD,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;IACjE,GAAG,CAAC,YAAY,KAAK,EAAE,CAAC;IACxB,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;IAChD,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,YAAY,KAAK,WAAW,IAAI,YAAY,KAAK,aAAa,EAAE,CAAC;QACnE,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC;IAChD,CAAC;IACD,MAAM,OAAO,GAAa;QACxB,UAAU,CACR,UAAU,EACV,eAAe,EACf,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EACnC,YAAY,CACb;KACF,CAAC;IACF,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,KAAK,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,4BAA4B,QAAQ,CAAC,IAAI,YAAY,MAAM,MAAM,CAAC;QAClF,OAAO,CAAC,IAAI,CACV,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CACxE,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IACtE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,UAAU,CAAC,IAAI,CACb,oCAAoC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,CACvE,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,2BAA2B,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,YAAY,GAAG,GAAG,MAAM,oBAAoB,QAAQ,CAAC,gBAAgB,IAAI,CAAC;QAChF,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YAChE,UAAU,CAAC,IAAI,CACb,4DAA4D,CAC7D,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;YACzC,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,OAAO,YAAY,IAAI,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC9D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,UAAU,CAAC,IAAI,CAAC,iDAAiD,KAAK,EAAE,CAAC,CAAC;YAC1E,SAAS;QACX,CAAC;QACD,KAAK,MAAM,UAAU,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CACtB,UAAU,EACV,SAAS,EACT,QAAQ,EACR,KAAK,EACL,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAClC,CAAC;YACF,OAAO,CAAC,IAAI,CACV,sBAAsB,CACpB,UAAU,EACV,MAAM,EACN,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,EAC3B,OAAO,EACP,UAAU,CACX,CACF,CAAC;YACF,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IACD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAC9B,UAAU,EACV,eAAe,EACf,UAAU,EACV,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAC9C,CAAC;IACF,MAAM,UAAU,GAAG;QACjB,eAAe,EAAE,QAAQ,CAAC,eAAe;QACzC,OAAO,EAAE,QAAQ,CAAC,IAAI;QACtB,OAAO,EAAE,MAAM,CAAC,cAAc;QAC9B,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;QAC3C,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM;QAC5B,KAAK,EAAE,UAAU,CAAC,IAAI,EAAE;KACzB,CAAC;IACF,OAAO,CAAC,IAAI,CACV,UAAU,CACR,UAAU,EACV,cAAc,EACd,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAC1C,YAAY,CACb,CACF,CAAC;IACF,IAAI,WAAW;QACb,QAAQ,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;IACxE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,SAAS,CAChB,MAA8B,EAC9B,UAAkB,EAClB,MAAwC;IAExC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,0BAA0B,EAAE,CAAC;QACxD,UAAU,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;QAC1E,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC/C,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QAC3B,UAAU,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QACpE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC/C,CAAC;IACD,MAAM,aAAa,GACjB,MAAM,KAAK,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IAC9E,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,qBAAqB,CAAC,CAAC;IACtE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,UAAU,CAAC,IAAI,CACb,8HAA8H,CAC/H,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC/C,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CACzB,aAAa,EACb,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,CACtC,CAAC;IACF,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,UAAU,CAAC,IAAI,CACb,gCAAgC,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,EAAE,CACrE,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC/C,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAC1B,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CACjC,CAAC;IACF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,UAAU,CAAC,IAAI,CACb,sCAAsC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,EAAE,CACzE,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC/C,CAAC;IACD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CACtB,SAAS,EACT,KAAK,EACL,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAClC,CAAC;QACF,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC;SACjC,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,CAAC,eAAe,EAAE,2BAA2B,CAAC,EAAE,CAAC;QAClE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAClD,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC;gBAChC,MAAM,EAAE,QAAQ;gBAChB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC;aACjC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,CAAC,IAAI,CAAC;QACX,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC;QAC1C,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CACxB,2BAA2B,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,EAC9D,IAAI,EACJ,CAAC,CACF,IAAI;KACN,CAAC,CAAC;IACH,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1E,QAAQ,CAAC,YAAY,KAAK,EAAE,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC;IAC5D,OAAO,CAAC,IAAI,CACV,UAAU,CACR,aAAa,EACb,mBAAmB,EACnB,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EACxC,YAAY,CACb,CACF,CAAC;IACF,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YAClE,UAAU,CAAC,IAAI,CACb,2EAA2E,CAC5E,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,+BAA+B;SACzC,CAAC,CAAC;IACL,CAAC;IACD,QAAQ,CAAC,IAAI,CACX,yHAAyH,CAC1H,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,2BAA2B,CAClC,KAA8B,EAC9B,aAAqB;IAErB,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAwB,CAAC;IAC7D,KAAK,MAAM,KAAK,IAAI,CAAC,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,CAAC,EAAE,CAAC;QAC5E,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAwC,CAAC;QAC1E,IAAI,CAAC,YAAY;YAAE,SAAS;QAC5B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YACzD,IACE,OAAO,KAAK,KAAK,QAAQ;gBACzB,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,EAClE,CAAC;gBACD,SAAS;YACX,CAAC;YACD,MAAM,SAAS,GAAG,wBAAwB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;YAChE,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CACb,oBAAoB,KAAK,IAAI,IAAI,mDAAmD,CACrF,CAAC;YACJ,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YACvE,IAAI,CAAC,OAAO;gBACV,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,iBAAiB,CAAC,CAAC;YACjE,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,EAAE,CAAC;QACrC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,oBAAoB,CAC3B,IAAY,EACZ,MAAc,EACd,OAAe,EACf,IAAoB,EACpB,UAAoB;IAEpB,OAAO,sBAAsB,CAC3B,IAAI,EACJ,MAAM,EACN,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EACpB,IAAI,EACJ,UAAU,CACX,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAC7B,IAAY,EACZ,MAAc,EACd,OAAe,EACf,IAAoB,EACpB,UAAoB;IAEpB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3D,CAAC;IACD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC3E,UAAU,CAAC,IAAI,CAAC,yBAAyB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACnE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAChD,CAAC;AAED,SAAS,UAAU,CACjB,IAAY,EACZ,MAAc,EACd,OAAe,EACf,IAAoB;IAEpB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3D,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;QACvE,IAAI;QACJ,OAAO;KACR,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,KAAK,CAAC,cAAc,EAAE;YACxB,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;QACvD,IAAI,KAAK,CAAC,WAAW,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;aACnD,IAAI,KAAK,CAAC,MAAM,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,SAAS,CAChB,OAA0C,EAC1C,MAA8B,EAC9B,MAAkE,EAClE,KAAc,EACd,OAAwE;IAExE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAC5B,OAAO;QACL,OAAO;QACP,OAAO,EAAE,QAAQ,CAAC,IAAI;QACtB,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,eAAe,EAAE,QAAQ,CAAC,eAAe;QACzC,UAAU,EAAE,MAAM,CAAC,IAAI;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK;QACL,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAC3C,aAAa,EAAE;YACb,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;YAC3C,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM;YAC5B,kBAAkB,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC;YACxE,aAAa,EAAE,QAAQ,CAAC,aAAa;SACtC;QACD,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YAC9D,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC;YACjC,MAAM;YACN,IAAI;SACL,CAAC,CAAC;QACH,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,MAA8B;IAClD,MAAM,KAAK,GAAG;QACZ,KAAK,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,cAAc,EAAE;QAChE,cAAc,MAAM,CAAC,eAAe,EAAE;QACtC,WAAW,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC,MAAM,GAAG;QACjD,SAAS,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE;QAC7C,eAAe,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;QACjD,EAAE;QACF,YAAY,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE;QACjD,WAAW,MAAM,CAAC,aAAa,CAAC,gBAAgB,EAAE;QAClD,WAAW,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE;QAC7D,yBAAyB,MAAM,CAAC,aAAa,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE;QACvF,mBAAmB,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE;QAC5E,EAAE;QACF,UAAU;QACV,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CACnB,CAAC,MAAM,EAAE,EAAE,CACT,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,GAAG,CACjE;KACF,CAAC;IACF,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CACR,EAAE,EACF,aAAa,EACb,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,CAClD,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,2DAA2D,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,IAAY,EACZ,OAAiB,EACjB,KAAuB;IAEvB,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,8BAA8B,CAAC,CAAC,CAAC;IAC9E,MAAM,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;IACnD,MAAM,WAAW,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,CAAC,gBAAgB,EAAE,mBAAmB,EAAE,WAAW,CAAC,CAAC,GAAG,CACxE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CACvC,CAAC;IACF,IAAI,CAAC;QACH,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,SAAS,CAAC,GAAG,CACX,MAAM,CAAC,IAAI,EACX,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CACjE,CAAC;YACF,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YACxD,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,OAAQ,CAAC,CAAC;QAC5C,CAAC;QACD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,SAAS,CAAC,GAAG,CACX,QAAQ,EACR,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAC3D,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,KAAK,IAAI,CAAC,CAAC;YACX,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7D,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,cAAc,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC,SAAS,CAAC,EAAE;YAChD,GAAG,EAAE,WAAW;YAChB,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,GAAG,cAAc,+BAA+B,MAAM,CAAC,MAAM,EAAE,CAChE,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YAClE,IAAI,QAAQ,KAAK,IAAI;gBAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpE,CAAC;gBACJ,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACtD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YAC5C,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,SAAiB,EAAE,IAAY;IACzD,IAAI,OAAO,GAAG,SAAS,CAAC;IACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO;YAC/C,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY;IACxC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IACpE,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IAC/D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAY;IAC1C,IAAI,GAAG,GAAG,IAAI,CAAC;IACf,OAAO,IAAI,EAAE,CAAC;QACZ,IACE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;YAC/C,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YAC1C,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC,EAClD,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAChC,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,IAAY;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxC,OAAO,KAAK,IAAI,GAAG,CAAC;AACtB,CAAC","sourcesContent":["import { spawnSync } from \"node:child_process\";\nimport fs from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\n\nimport {\n assertAgentNativePackageManifest,\n type AgentNativePackageManifest,\n} from \"../package-lifecycle/manifest.js\";\n\nexport interface PackageLifecycleIO {\n out(message: string): void;\n err(message: string): void;\n}\n\nexport interface LoadedLifecyclePackage {\n manifest: AgentNativePackageManifest;\n packageVersion: string;\n packageDir: string;\n packageJson: Record<string, unknown>;\n cleanup?: () => void;\n}\n\nexport interface PackageLifecycleRuntime {\n cwd?: string;\n io?: PackageLifecycleIO;\n loadPackage?: (name: string, cwd: string) => Promise<LoadedLifecyclePackage>;\n spawn?: typeof spawnSync;\n}\n\ninterface Change {\n path: string;\n action: \"create\" \| \"update\" \| \"noop\";\n kind:\n \| \"dependency\"\n \| \"action\"\n \| \"schema\"\n \| \"skill\"\n \| \"provenance\"\n \| \"eject\"\n \| \"workspace\";\n content?: string \| Buffer;\n}\n\nexport interface PackageLifecycleReport {\n command: \"inspect\" \| \"add\" \| \"eject\";\n package: string;\n packageVersion: string;\n manifestVersion: number;\n targetRoot: string;\n layout: \"standalone\" \| \"workspace-app\" \| \"workspace-root\";\n apply: boolean;\n compatible: boolean;\n contributions: {\n actions: string[];\n schemaEntryPoint: string;\n skills: string[];\n requiredSecretKeys: string[];\n peerProviders: string[];\n };\n changes: Array<Omit<Change, \"content\">>;\n collisions: string[];\n warnings: string[];\n}\n\nconst defaultIO: PackageLifecycleIO = {\n out: (message) => console.log(message),\n err: (message) => console.error(message),\n};\n\nexport async function runPackageLifecycle(\n args: string[],\n runtime: PackageLifecycleRuntime = {},\n): Promise<number> {\n const io = runtime.io ?? defaultIO;\n const command = args[0];\n const packageName = args[1];\n if (!isCommand(command) \|\| !packageName) {\n io.err(packageLifecycleUsage());\n return 1;\n }\n const json = args.includes(\"--json\");\n const apply = args.includes(\"--apply\");\n if (apply && command === \"inspect\") {\n io.err(\"package inspect is always read-only; remove --apply\");\n return 1;\n }\n const cwd = path.resolve(\n flagValue(args, \"--root\") ?? runtime.cwd ?? process.cwd(),\n );\n let loaded: LoadedLifecyclePackage \| undefined;\n try {\n loaded = await (runtime.loadPackage\n ? runtime.loadPackage(packageName, cwd)\n : loadLifecyclePackage(packageName, cwd, runtime.spawn ?? spawnSync));\n if (loaded.manifest.name !== packageName) {\n throw new Error(\n `Manifest name ${loaded.manifest.name} does not match requested package ${packageName}`,\n );\n }\n const target = resolveTarget(cwd, flagValue(args, \"--app\"));\n const planned =\n command === \"eject\"\n ? planEject(loaded, target.root, target.layout)\n : planAdd(loaded, target.root, target.layout, command === \"inspect\");\n const report = reportFor(command, loaded, target, apply, planned);\n if (report.collisions.length > 0) {\n report.compatible = false;\n }\n if (json) io.out(JSON.stringify(report, null, 2));\n else io.out(formatReport(report));\n if (!report.compatible) return 1;\n if (command === \"inspect\" \|\| !apply) return 0;\n\n await applyTransaction(\n target.root,\n planned.changes.filter((change) => change.action !== \"noop\"),\n runtime.spawn ?? spawnSync,\n );\n return 0;\n } catch (error) {\n io.err(error instanceof Error ? error.message : String(error));\n return 1;\n } finally {\n loaded?.cleanup?.();\n }\n}\n\nfunction isCommand(\n value: string \| undefined,\n): value is \"inspect\" \| \"add\" \| \"eject\" {\n return value === \"inspect\" \|\| value === \"add\" \|\| value === \"eject\";\n}\n\nfunction flagValue(args: string[], name: string): string \| undefined {\n const index = args.indexOf(name);\n return index >= 0 ? args[index + 1] : undefined;\n}\n\nexport function packageLifecycleUsage(): string {\n return [\n \"Install-on-demand Toolkit capability module lifecycle:\",\n \"\",\n \"Usage:\",\n \" agent-native package inspect <package> [--root <dir>] [--app <name>] [--json]\",\n \" agent-native package add <package> [--root <dir>] [--app <name>] [--apply] [--json]\",\n \" agent-native package eject <package> [--root <dir>] [--app <name>] [--apply] [--json]\",\n \"\",\n \"add and eject are dry-run by default; pass --apply to write and run the package manager.\",\n ].join(\"\\n\");\n}\n\nexport async function loadLifecyclePackage(\n name: string,\n cwd: string,\n spawn: typeof spawnSync = spawnSync,\n): Promise<LoadedLifecyclePackage> {\n const packageJsonPath = findInstalledPackageJson(name, cwd);\n if (packageJsonPath) {\n return loadStaticPackageDirectory(name, path.dirname(packageJsonPath));\n }\n if (!/^(@[a-z0-9._-]+\\/)?[a-z0-9._-]+$/.test(name)) {\n throw new Error(`Invalid package name: ${name}`);\n }\n const stage = fs.mkdtempSync(\n path.join(os.tmpdir(), \"agent-native-package-inspect-\"),\n );\n try {\n const packed = spawn(\n \"npm\",\n [\"pack\", name, \"--ignore-scripts\", \"--json\", \"--pack-destination\", stage],\n { cwd, encoding: \"utf8\", stdio: \"pipe\" },\n );\n if (packed.status !== 0) {\n throw new Error(`Unable to download package metadata for '${name}'`);\n }\n const entries = JSON.parse(String(packed.stdout \|\| \"[]\")) as Array<{\n filename?: string;\n }>;\n const filename = entries[0]?.filename;\n if (!filename \|\| path.basename(filename) !== filename) {\n throw new Error(\n `npm pack returned an invalid archive name for '${name}'`,\n );\n }\n const archive = path.join(stage, filename);\n const listed = spawn(\"tar\", [\"-tzf\", archive], {\n cwd,\n encoding: \"utf8\",\n stdio: \"pipe\",\n });\n if (listed.status !== 0) {\n throw new Error(`Unable to list package archive for '${name}'`);\n }\n const archiveEntries = String(listed.stdout \|\| \"\")\n .split(/\\r?\\n/)\n .filter(Boolean);\n if (\n archiveEntries.length === 0 \|\|\n archiveEntries.some(\n (entry) =>\n entry.includes(\"\\\\\") \|\|\n entry.startsWith(\"/\") \|\|\n !entry.startsWith(\"package/\") \|\|\n entry.split(\"/\").includes(\"..\"),\n )\n ) {\n throw new Error(`Package archive for '${name}' contains an unsafe path`);\n }\n const extracted = spawn(\n \"tar\",\n [\n \"-xzf\",\n archive,\n \"-C\",\n stage,\n \"--no-same-owner\",\n \"--no-same-permissions\",\n ],\n {\n cwd,\n encoding: \"utf8\",\n stdio: \"pipe\",\n },\n );\n if (extracted.status !== 0) {\n throw new Error(`Unable to inspect package archive for '${name}'`);\n }\n const loaded = loadStaticPackageDirectory(\n name,\n path.join(stage, \"package\"),\n );\n loaded.cleanup = () => fs.rmSync(stage, { recursive: true, force: true });\n return loaded;\n } catch (error) {\n fs.rmSync(stage, { recursive: true, force: true });\n throw error;\n }\n}\n\nfunction loadStaticPackageDirectory(\n name: string,\n packageDir: string,\n): LoadedLifecyclePackage {\n const packageJsonPath = path.join(packageDir, \"package.json\");\n const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, \"utf8\")) as {\n name?: string;\n version?: string;\n agentNativeManifest?: string;\n [key: string]: unknown;\n };\n if (packageJson.name !== name) {\n throw new Error(\n `Installed package name ${String(packageJson.name)} does not match ${name}`,\n );\n }\n if (!packageJson.version) {\n throw new Error(`Package '${name}' has no version`);\n }\n if (\n !/^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$/.test(\n packageJson.version,\n )\n ) {\n throw new Error(`Package '${name}' has an invalid version`);\n }\n const relativeManifest = packageJson.agentNativeManifest;\n if (!relativeManifest \|\| path.isAbsolute(relativeManifest)) {\n throw new Error(\n `Package '${name}' does not declare a static agentNativeManifest`,\n );\n }\n const manifestPath = path.resolve(packageDir, relativeManifest);\n if (\n manifestPath !== packageDir &&\n !manifestPath.startsWith(`${path.resolve(packageDir)}${path.sep}`)\n ) {\n throw new Error(`Package '${name}' manifest escapes the package directory`);\n }\n const manifestStat = fs.lstatSync(manifestPath);\n if (!manifestStat.isFile() \|\| manifestStat.isSymbolicLink()) {\n throw new Error(`Package '${name}' static manifest must be a regular file`);\n }\n const realPackageDir = fs.realpathSync(packageDir);\n const realManifestPath = fs.realpathSync(manifestPath);\n if (!realManifestPath.startsWith(`${realPackageDir}${path.sep}`)) {\n throw new Error(\n `Package '${name}' static manifest escapes the package directory`,\n );\n }\n const manifest = JSON.parse(fs.readFileSync(manifestPath, \"utf8\"));\n assertAgentNativePackageManifest(manifest);\n if (manifest.name !== name) {\n throw new Error(`Manifest name ${manifest.name} does not match ${name}`);\n }\n return {\n manifest,\n packageVersion: packageJson.version,\n packageDir,\n packageJson,\n };\n}\n\nfunction findInstalledPackageJson(name: string, from: string): string \| null {\n let dir = from;\n while (true) {\n const candidate = path.join(dir, \"node_modules\", name, \"package.json\");\n if (fs.existsSync(candidate)) return candidate;\n const parent = path.dirname(dir);\n if (parent === dir) return null;\n dir = parent;\n }\n}\n\nfunction resolveTarget(\n root: string,\n appName?: string,\n): { root: string; layout: PackageLifecycleReport[\"layout\"] } {\n const packageJsonPath = path.join(root, \"package.json\");\n if (!fs.existsSync(packageJsonPath)) {\n throw new Error(`Target root has no package.json: ${root}`);\n }\n const pkg = JSON.parse(fs.readFileSync(packageJsonPath, \"utf8\"));\n const workspace =\n typeof pkg?.[\"agent-native\"]?.workspaceCore === \"string\" &&\n fs.existsSync(path.join(root, \"apps\"));\n if (!workspace) return { root, layout: \"standalone\" };\n if (!appName) {\n return { root, layout: \"workspace-root\" };\n }\n if (!/^[a-z0-9][a-z0-9-]$/.test(appName)) {\n throw new Error(`Invalid workspace app name: ${appName}`);\n }\n const appRoot = path.join(root, \"apps\", appName);\n if (!fs.existsSync(path.join(appRoot, \"package.json\"))) {\n throw new Error(`Workspace app not found: ${appRoot}`);\n }\n return { root: appRoot, layout: \"workspace-app\" };\n}\n\nfunction planAdd(\n loaded: LoadedLifecyclePackage,\n targetRoot: string,\n layout: PackageLifecycleReport[\"layout\"],\n inspectOnly: boolean,\n): { changes: Change[]; collisions: string[]; warnings: string[] } {\n const { manifest, packageDir } = loaded;\n const collisions: string[] = [];\n const warnings: string[] = [];\n if (layout === \"workspace-root\") {\n collisions.push(\"Workspace root is ambiguous; pass --app <name> for add\");\n return { changes: [], collisions, warnings };\n }\n const packageJsonPath = path.join(targetRoot, \"package.json\");\n const pkg = JSON.parse(fs.readFileSync(packageJsonPath, \"utf8\"));\n pkg.dependencies ??= {};\n const wantedRange = `^${loaded.packageVersion}`;\n const currentRange = pkg.dependencies[manifest.name];\n if (currentRange !== wantedRange && currentRange !== \"workspace:\") {\n pkg.dependencies[manifest.name] = wantedRange;\n }\n const changes: Change[] = [\n textChange(\n targetRoot,\n packageJsonPath,\n `${JSON.stringify(pkg, null, 2)}\\n`,\n \"dependency\",\n ),\n ];\n for (const action of manifest.actions) {\n const target = path.join(targetRoot, \"actions\", `${action}.ts`);\n const content = `export { default } from \"${manifest.name}/actions/${action}\";\\n`;\n changes.push(\n collisionCheckedText(targetRoot, target, content, \"action\", collisions),\n );\n }\n\n const schemaPath = path.join(targetRoot, \"server\", \"db\", \"schema.ts\");\n if (!fs.existsSync(schemaPath)) {\n collisions.push(\n `Required schema file is missing: ${relative(targetRoot, schemaPath)}`,\n );\n } else {\n const current = fs.readFileSync(schemaPath, \"utf8\");\n const marker = `// agent-native-package:${manifest.name}`;\n const contribution = `${marker}\\nexport * from \"${manifest.schemaEntryPoint}\";`;\n if (current.includes(marker) && !current.includes(contribution)) {\n collisions.push(\n \"Existing package-owned schema block has unexpected content\",\n );\n }\n const next = current.includes(contribution)\n ? current\n : `${current.trimEnd()}\\n\\n${contribution}\\n`;\n changes.push(textChange(targetRoot, schemaPath, next, \"schema\"));\n }\n\n const ownedPaths: string[] = [];\n for (const skill of manifest.docs.skills) {\n const source = path.join(packageDir, \"docs\", \"skills\", skill);\n if (!fs.existsSync(source)) {\n collisions.push(`Manifest skill source is missing: docs/skills/${skill}`);\n continue;\n }\n for (const sourceFile of walkFiles(source)) {\n const target = path.join(\n targetRoot,\n \".agents\",\n \"skills\",\n skill,\n path.relative(source, sourceFile),\n );\n changes.push(\n collisionCheckedBuffer(\n targetRoot,\n target,\n fs.readFileSync(sourceFile),\n \"skill\",\n collisions,\n ),\n );\n ownedPaths.push(relative(targetRoot, target));\n }\n }\n const provenancePath = path.join(\n targetRoot,\n \".agent-native\",\n \"packages\",\n `${manifest.name.replaceAll(\"/\", \"__\")}.json`,\n );\n const provenance = {\n manifestVersion: manifest.manifestVersion,\n package: manifest.name,\n version: loaded.packageVersion,\n actions: manifest.actions,\n schemaEntryPoint: manifest.schemaEntryPoint,\n skills: manifest.docs.skills,\n files: ownedPaths.sort(),\n };\n changes.push(\n textChange(\n targetRoot,\n provenancePath,\n `${JSON.stringify(provenance, null, 2)}\\n`,\n \"provenance\",\n ),\n );\n if (inspectOnly)\n warnings.push(\"inspect is read-only; shown changes are the add plan\");\n return { changes, collisions, warnings };\n}\n\nfunction planEject(\n loaded: LoadedLifecyclePackage,\n targetRoot: string,\n layout: PackageLifecycleReport[\"layout\"],\n): { changes: Change[]; collisions: string[]; warnings: string[] } {\n const collisions: string[] = [];\n const warnings: string[] = [];\n if (loaded.manifest.name !== \"@agent-native/scheduling\") {\n collisions.push(\"Eject currently supports only @agent-native/scheduling\");\n return { changes: [], collisions, warnings };\n }\n if (!loaded.manifest.eject) {\n collisions.push(\"Package manifest does not declare eject metadata\");\n return { changes: [], collisions, warnings };\n }\n const workspaceRoot =\n layout === \"workspace-app\" ? path.resolve(targetRoot, \"../..\") : targetRoot;\n const pnpmWorkspace = path.join(workspaceRoot, \"pnpm-workspace.yaml\");\n if (!fs.existsSync(pnpmWorkspace)) {\n collisions.push(\n \"Eject currently requires an existing pnpm workspace; refusing to create a workspace:* dependency for another package manager\",\n );\n return { changes: [], collisions, warnings };\n }\n const targetDir = path.join(\n workspaceRoot,\n loaded.manifest.eject.targetDirectory,\n );\n if (fs.existsSync(targetDir)) {\n collisions.push(\n `Eject target already exists: ${relative(workspaceRoot, targetDir)}`,\n );\n return { changes: [], collisions, warnings };\n }\n const sourceRoot = path.join(\n loaded.packageDir,\n loaded.manifest.eject.sourceRoot,\n );\n if (!fs.existsSync(sourceRoot)) {\n collisions.push(\n `Published eject source is missing: ${loaded.manifest.eject.sourceRoot}`,\n );\n return { changes: [], collisions, warnings };\n }\n const changes: Change[] = [];\n for (const source of walkFiles(sourceRoot)) {\n const target = path.join(\n targetDir,\n \"src\",\n path.relative(sourceRoot, source),\n );\n changes.push({\n path: target,\n action: \"create\",\n kind: \"eject\",\n content: fs.readFileSync(source),\n });\n }\n for (const name of [\"tsconfig.json\", \"agent-native.package.json\"]) {\n const source = path.join(loaded.packageDir, name);\n if (fs.existsSync(source)) {\n changes.push({\n path: path.join(targetDir, name),\n action: \"create\",\n kind: \"eject\",\n content: fs.readFileSync(source),\n });\n }\n }\n changes.push({\n path: path.join(targetDir, \"package.json\"),\n action: \"create\",\n kind: \"eject\",\n content: `${JSON.stringify(\n normalizeEjectedPackageJson(loaded.packageJson, workspaceRoot),\n null,\n 2,\n )}\\n`,\n });\n const consumerPackageJson = path.join(targetRoot, \"package.json\");\n const consumer = JSON.parse(fs.readFileSync(consumerPackageJson, \"utf8\"));\n consumer.dependencies ??= {};\n consumer.dependencies[loaded.manifest.name] = \"workspace:\";\n changes.push(\n textChange(\n workspaceRoot,\n consumerPackageJson,\n `${JSON.stringify(consumer, null, 2)}\\n`,\n \"dependency\",\n ),\n );\n if (fs.existsSync(pnpmWorkspace)) {\n const text = fs.readFileSync(pnpmWorkspace, \"utf8\");\n if (!text.includes(\"packages/\") && !text.includes(\"packages/*\")) {\n collisions.push(\n \"pnpm-workspace.yaml does not include packages/; refusing to rewrite YAML\",\n );\n }\n } else {\n changes.push({\n path: pnpmWorkspace,\n action: \"create\",\n kind: \"workspace\",\n content: 'packages:\\n - \"packages/*\"\\n',\n });\n }\n warnings.push(\n \"Imports keep the canonical @agent-native/scheduling specifier; workspace resolution switches them to the local package.\",\n );\n return { changes, collisions, warnings };\n}\n\nfunction normalizeEjectedPackageJson(\n input: Record<string, unknown>,\n workspaceRoot: string,\n): Record<string, unknown> {\n const output = structuredClone(input) as Record<string, any>;\n for (const field of [\"dependencies\", \"devDependencies\", \"peerDependencies\"]) {\n const dependencies = output[field] as Record<string, unknown> \| undefined;\n if (!dependencies) continue;\n for (const [name, range] of Object.entries(dependencies)) {\n if (\n typeof range !== \"string\" \|\|\n (!range.startsWith(\"workspace:\") && !range.startsWith(\"catalog:\"))\n ) {\n continue;\n }\n const installed = findInstalledPackageJson(name, workspaceRoot);\n if (!installed) {\n throw new Error(\n `Cannot normalize ${field}.${name}; the installed dependency version is unavailable`,\n );\n }\n const version = JSON.parse(fs.readFileSync(installed, \"utf8\")).version;\n if (!version)\n throw new Error(`Installed dependency ${name} has no version`);\n dependencies[name] = `^${version}`;\n }\n }\n return output;\n}\n\nfunction collisionCheckedText(\n root: string,\n target: string,\n content: string,\n kind: Change[\"kind\"],\n collisions: string[],\n): Change {\n return collisionCheckedBuffer(\n root,\n target,\n Buffer.from(content),\n kind,\n collisions,\n );\n}\n\nfunction collisionCheckedBuffer(\n root: string,\n target: string,\n content: Buffer,\n kind: Change[\"kind\"],\n collisions: string[],\n): Change {\n if (!fs.existsSync(target)) {\n return { path: target, action: \"create\", kind, content };\n }\n const current = fs.readFileSync(target);\n if (current.equals(content)) return { path: target, action: \"noop\", kind };\n collisions.push(`Refusing to overwrite ${relative(root, target)}`);\n return { path: target, action: \"noop\", kind };\n}\n\nfunction textChange(\n root: string,\n target: string,\n content: string,\n kind: Change[\"kind\"],\n): Change {\n if (!fs.existsSync(target))\n return { path: target, action: \"create\", kind, content };\n return {\n path: target,\n action: fs.readFileSync(target, \"utf8\") === content ? \"noop\" : \"update\",\n kind,\n content,\n };\n}\n\nfunction walkFiles(root: string): string[] {\n const files: string[] = [];\n for (const entry of fs.readdirSync(root, { withFileTypes: true })) {\n const full = path.join(root, entry.name);\n if (entry.isSymbolicLink())\n throw new Error(`Refusing package symlink: ${full}`);\n if (entry.isDirectory()) files.push(...walkFiles(full));\n else if (entry.isFile()) files.push(full);\n }\n return files.sort();\n}\n\nfunction reportFor(\n command: PackageLifecycleReport[\"command\"],\n loaded: LoadedLifecyclePackage,\n target: { root: string; layout: PackageLifecycleReport[\"layout\"] },\n apply: boolean,\n planned: { changes: Change[]; collisions: string[]; warnings: string[] },\n): PackageLifecycleReport {\n const { manifest } = loaded;\n return {\n command,\n package: manifest.name,\n packageVersion: loaded.packageVersion,\n manifestVersion: manifest.manifestVersion,\n targetRoot: target.root,\n layout: target.layout,\n apply,\n compatible: planned.collisions.length === 0,\n contributions: {\n actions: manifest.actions,\n schemaEntryPoint: manifest.schemaEntryPoint,\n skills: manifest.docs.skills,\n requiredSecretKeys: manifest.requiredSecrets.map((secret) => secret.key),\n peerProviders: manifest.peerProviders,\n },\n changes: planned.changes.map(({ path: file, action, kind }) => ({\n path: relative(target.root, file),\n action,\n kind,\n })),\n collisions: planned.collisions,\n warnings: planned.warnings,\n };\n}\n\nfunction formatReport(report: PackageLifecycleReport): string {\n const lines = [\n `# ${report.command} ${report.package}@${report.packageVersion}`,\n `Manifest: v${report.manifestVersion}`,\n `Target: ${report.targetRoot} (${report.layout})`,\n `Mode: ${report.apply ? \"apply\" : \"dry-run\"}`,\n `Compatible: ${report.compatible ? \"yes\" : \"no\"}`,\n \"\",\n `Actions: ${report.contributions.actions.length}`,\n `Schema: ${report.contributions.schemaEntryPoint}`,\n `Skills: ${report.contributions.skills.join(\", \") \|\| \"none\"}`,\n `Required secret keys: ${report.contributions.requiredSecretKeys.join(\", \") \|\| \"none\"}`,\n `Peer providers: ${report.contributions.peerProviders.join(\", \") \|\| \"none\"}`,\n \"\",\n \"Changes:\",\n ...report.changes.map(\n (change) =>\n ` ${change.action.padEnd(6)} ${change.path} (${change.kind})`,\n ),\n ];\n if (report.collisions.length) {\n lines.push(\n \"\",\n \"Collisions:\",\n ...report.collisions.map((item) => ` - ${item}`),\n );\n }\n if (report.warnings.length) {\n lines.push(\"\", \"Notes:\", ...report.warnings.map((item) => ` - ${item}`));\n }\n if (!report.apply && report.command !== \"inspect\") {\n lines.push(\"\", \"Dry-run only. Re-run with --apply to write these changes.\");\n }\n return lines.join(\"\\n\");\n}\n\nasync function applyTransaction(\n root: string,\n changes: Change[],\n spawn: typeof spawnSync,\n): Promise<void> {\n const stage = fs.mkdtempSync(path.join(root, \".agent-native-package-stage-\"));\n const snapshots = new Map<string, Buffer \| null>();\n const installRoot = findPackageManagerRoot(root);\n const lockfiles = [\"pnpm-lock.yaml\", \"package-lock.json\", \"yarn.lock\"].map(\n (name) => path.join(installRoot, name),\n );\n try {\n for (const change of changes) {\n snapshots.set(\n change.path,\n fs.existsSync(change.path) ? fs.readFileSync(change.path) : null,\n );\n const staged = path.join(stage, String(snapshots.size));\n fs.writeFileSync(staged, change.content!);\n }\n for (const lockfile of lockfiles) {\n snapshots.set(\n lockfile,\n fs.existsSync(lockfile) ? fs.readFileSync(lockfile) : null,\n );\n }\n let index = 0;\n for (const change of changes) {\n index += 1;\n fs.mkdirSync(path.dirname(change.path), { recursive: true });\n fs.renameSync(path.join(stage, String(index)), change.path);\n }\n const packageManager = detectPackageManager(installRoot);\n const result = spawn(packageManager, [\"install\"], {\n cwd: installRoot,\n stdio: \"inherit\",\n });\n if (result.status !== 0) {\n throw new Error(\n `${packageManager} install failed with status ${result.status}`,\n );\n }\n } catch (error) {\n for (const [file, snapshot] of [...snapshots.entries()].reverse()) {\n if (snapshot === null) fs.rmSync(file, { force: true, recursive: true });\n else {\n fs.mkdirSync(path.dirname(file), { recursive: true });\n fs.writeFileSync(file, snapshot);\n }\n }\n for (const change of [...changes].reverse()) {\n removeEmptyParents(path.dirname(change.path), root);\n }\n throw error;\n } finally {\n fs.rmSync(stage, { recursive: true, force: true });\n }\n}\n\nfunction removeEmptyParents(directory: string, stop: string): void {\n let current = directory;\n const boundary = path.resolve(stop);\n while (current.startsWith(`${boundary}${path.sep}`)) {\n try {\n if (fs.readdirSync(current).length > 0) return;\n fs.rmdirSync(current);\n } catch {\n return;\n }\n current = path.dirname(current);\n }\n}\n\nfunction detectPackageManager(root: string): \"pnpm\" \| \"yarn\" \| \"npm\" {\n if (fs.existsSync(path.join(root, \"pnpm-lock.yaml\"))) return \"pnpm\";\n if (fs.existsSync(path.join(root, \"yarn.lock\"))) return \"yarn\";\n return \"npm\";\n}\n\nfunction findPackageManagerRoot(from: string): string {\n let dir = from;\n while (true) {\n if (\n fs.existsSync(path.join(dir, \"pnpm-lock.yaml\")) \|\|\n fs.existsSync(path.join(dir, \"yarn.lock\")) \|\|\n fs.existsSync(path.join(dir, \"package-lock.json\"))\n ) {\n return dir;\n }\n const parent = path.dirname(dir);\n if (parent === dir) return from;\n dir = parent;\n }\n}\n\nfunction relative(root: string, file: string): string {\n const value = path.relative(root, file);\n return value \|\| \".\";\n}\n"]}

package/dist/cli/skills-content/visual-plan-skill.d.ts CHANGED Viewed

@@ -1,2 +1,2 @@
-export declare const VISUAL_PLANS_SKILL_MD = "---\nname: visual-plan\ndescription: >-\n  Turn ordinary text plans into rich interactive visual plans with diagrams,\n  file maps, annotated code, open questions, and UI/prototype review when\n  useful.\nmetadata:\n  visibility: exported\n---\n\n# Agent-Native Plans\n\nAgent-Native Plans is structured visual planning mode for coding agents. Build\nthe plan you would normally write in Markdown, but as a scannable document with\neditable blocks mixed in: inline diagrams, code snippets,\nopen questions, and an optional top visual review area (wireframe canvas, live\nprototype, or both in tabs). Architecture and backend plans stay document-only;\nUI and product plans start with the top canvas/prototype (the Visual Surface\nChoice section owns that rule).\n\n`/visual-plan` is the packaged command and main entry point. Choose the review\nmode from the task: UI-first when the work is primarily product UI and review\nshould start with screens, prototype-first when review should start with a\nfunctional live prototype, design-first when review needs full-fidelity branded\nscreens, or visual-intake when the user explicitly wants a questionnaire before\nplanning. When a Codex, Claude Code, Markdown, or pasted plan already exists,\n`/visual-plan` uses that source plan as the starting point and builds the review\nsurface from it instead of starting over.\n\n## When To Use\n\nCreate or adapt a visual plan whenever the plan would be better as a reviewable\nartifact than a chat paragraph. This includes modest work such as a single UI\nsurface with states, a small workflow, a before/after product change, or a\ncomponent/API/data-shape decision that needs alignment, plus larger multi-file,\nambiguous, long-running, risky, or UI-heavy work. Use it when architecture /\ndata flow / UI direction / options / open questions would benefit from inline\ndiagrams or structured blocks, when the user needs to react to a direction\nbefore you implement, or when an existing text plan needs a richer review\nsurface.\n\n## Plan Discipline\n\n- **Gate thoughtfully.** A visual plan is a richer review surface, not only a\n  tool for giant projects. Use it when the user needs to see, compare, comment\n  on, or approve a direction before code, even for a modest UI/state/workflow\n  change. Skip it for truly trivial, unambiguous work \u2014 typos, one-line fixes, a\n  single well-specified function, anything whose diff you could describe in one\n  sentence \u2014 and just make the change. Never pad a plan with filler and never\n  ship a single-step plan.\n- **Research before you draft.** Read the real files, actions, schema, and\n  patterns first; name actual files, symbols, and data shapes instead of\n  inventing them. Check existing `actions/` before proposing endpoints and prefer\n  named client helpers over raw fetch. Delegate wide exploration to a sub-agent.\n  Lead with reuse: for each step, name what it reuses \u2014 existing actions, schema,\n  components, helpers \u2014 before what it adds, so the plan explains the genuinely new\n  delta instead of redescribing what already exists.\n- **Decide the hard-to-reverse bets first.** For non-trivial backend, data, or API\n  work, sketch where the feature is headed, then call out the decisions that are\n  expensive to undo once data or callers depend on them \u2014 wire format, public ids,\n  data-model shape, auth and ownership boundaries \u2014 and get those right in the plan\n  even if most of the feature ships later. Then scope to the smallest first cut that\n  proves the approach without foreclosing it, stating both what is in and what is\n  explicitly deferred.\n- **Keep examples at the right altitude.** When the user's idea is a broad\n  framework, product, or operating-model change, do not collapse it into the\n  first concrete example, provider, or sync path they mention. Separate the core\n  abstraction from motivating examples and app/provider adapters. Use examples\n  to make the plan legible, but label them as examples unless they are the whole\n  requested scope.\n- **Publish standalone plans.** If the user pasted, referenced, or already has a\n  Codex / Claude Code / Markdown plan, treat it as source material, but rewrite\n  the published plan as a clean standalone proposal. Preserve the source plan's\n  useful intent and codebase facts, label inferred visuals as inferred, and avoid\n  revision language such as \"preserve the prior plan\", \"do not drop the old\n  idea\", \"unlike the previous version\", or \"this revision changes...\". A reader\n  who never saw the chat or earlier drafts should understand the plan.\n- **Make the first read concrete.** If the plan is meant to be shared with\n  someone outside the chat, or if the concept is abstract, lead near the top with\n  one concrete product example before mode tables, architecture, or roadmaps. For\n  UI-capable concepts, that usually means a top-canvas app state that shows the\n  real user workflow in product terms. Do not rely on phrases that only make\n  sense in conversation, and do not frame the plan as \"not the old idea\"; state\n  the positive model directly.\n- **Planning is read-only.** Make no source edits while building or reviewing the\n  plan. Start editing only after the user approves the direction.\n- **Clarify vs. assume.** Do not ask how to build it \u2014 explore and present the\n  approach and options in the plan. Ask a clarifying question only when an\n  ambiguity would change the design and you cannot resolve it from the code; use\n  the host agent's normal ask-user-question flow and batch 2-4 high-leverage\n  questions before finalizing. Do not call `create-visual-questions` for\n  ordinary clarification or preflight; reserve it for the visual-intake mode when\n  the user explicitly asks for a visual intake questionnaire. Otherwise state the\n  assumption explicitly and proceed, and keep anything unresolved in the plan's\n  single bottom `question-form` Open Questions block. For complex plans, do a\n  final open-question pass before handoff: if a decision would affect\n  architecture, scope, UX, data shape, or rollout, either decide it in the plan\n  with rationale or put it in that bottom form with a recommended default.\n- **The plan is the approval gate.** After surfacing it, ask the user to review\n  and approve before you write code, and name which files/areas the work touches.\n  Presenting the plan and requesting sign-off is the approval step \u2014 do not ask a\n  separate \"does this look good?\" question.\n- **The document is the source of truth, not the chat.** When scope shifts,\n  update the plan with `update-visual-plan` rather than only changing course in\n  chat, and make the updated document stand alone. Do not describe the update as\n  a correction to an earlier draft inside the plan itself. Re-read the approved\n  plan before major steps.\n\n## Create A Structured Agent-Native Plan \u2014 Never Inline\n\nThe deliverable is ALWAYS a structured Agent-Native Plan, not a chat-only plan.\nThe hosted Plan MCP connector (`plan` server, or legacy `agent-native-plans`) is\nthe default collaboration and commenting surface; it is not a reason to reject\nthe planning pattern as an external dependency or rented layer. Plans are\nportable source artifacts (`plan.mdx`, optional `canvas.mdx` /\n`prototype.mdx`, JSON, and HTML export), and ownership-sensitive workflows can\nuse local-files mode or a self-hosted/custom Plan app URL without abandoning the\nskill's review discipline. Do not advise the user to skip `/visual-plan` because\nthe default surface is hosted; choose the right Plan mode for the user's\nownership, privacy, sharing, and branding needs.\n\nBy default, create the plan via the Plan MCP connector and NEVER hand it over as\ninline chat content \u2014 no Markdown prose, ASCII sketch, table, or fenced\nwireframe. If the `plan` (or legacy `agent-native-plans`) tools are not visible,\ndiscover them through the host's `tool_search` first; if they are still missing,\nSTOP and give the user the client-specific reconnect step rather than improvising\nan inline plan. Before publishing, or whenever a connector or auth error appears,\nREAD `references/connection.md` in this skill directory \u2014 it is the single source\nof truth for the never-inline rule, connector discovery, and the per-client\nreconnect steps. Local-files privacy mode (after Tool Guidance) is the exception.\n\n## Core Workflow\n\nThis section describes the default hosted Plan MCP workflow. If\n`AGENT_NATIVE_PLANS_MODE=local-files` is set, or the user asks for fully local\nfiles/no hosted Plan writes, use **Local-Files Privacy Mode** instead; carry\nforward only the code-research and plan-composition guidance here.\n\n1. Follow the host agent's normal planning flow: inspect the codebase, delegate\n   wide exploration when useful, gather the info needed, and ask native\n   clarifying questions as needed before generating the plan. If a source plan\n   already exists, gather its exact text from the user's paste, a referenced\n   file, or recent visible agent context; do not invent source text.\n2. Call `get-plan-blocks` for the authoritative block catalog \u2014 do not author\n   from memorized tags. Then call the mode-matched create tool:\n   `create-visual-plan` for document-first plans (architecture, backend, data,\n   refactor, API), `create-ui-plan` for UI-first plans, `create-prototype-plan`\n   for prototype-first plans, `create-plan-design` for design-first plans,\n   `create-visual-questions` only when the user explicitly asks for a visual\n   intake questionnaire. When a source plan already exists,\n   pass it as `planText` and preserve the original plan's useful intent while\n   producing a standalone plan document, not a revision memo.\n3. For UI/product plans, compose the top canvas first with the primary\n   wireframes and annotated states, then write the document with native blocks\n   (see `references/canvas.md` and `references/document-quality.md`). For\n   broad product architecture plans with a user-facing implication, add a\n   concrete \"what this looks like in the app\" visual before the abstract\n   architecture or mode tables. Keep the document close to the standalone\n   Markdown plan the agent would normally output. If an existing plan was\n   provided, carry forward the right facts and decisions without referring to\n   the previous draft or explaining how this version differs. For non-visual\n   plans, skip the top visual surface (Visual Surface Choice below owns the rule)\n   and put `diagram`, `data-model`,\n   `api-endpoint`, `diff`, `file-tree`, `code`, and `annotated-code` blocks\n   directly next to the relevant prose.\n   Wide document layout is renderer-owned and intentionally allowlisted: only\n   literal code-review surfaces (`diff`, `annotated-code`) and `tabs` blocks\n   with vertical orientation or diff-like children break out wider than prose.\n   Keep `api-endpoint`, `openapi-spec`, `data-model`, `json-explorer`,\n   `wireframe`, question, and `custom-html` blocks in normal document flow unless\n   their own renderer says otherwise.\n4. Surface the returned Plans link or inline MCP App and ask the user to review.\n   Always include the actual URL in chat so the next step is a click in CLI or\n   other text-only hosts. When the host exposes an embedded browser/preview panel\n   and a tool can open arbitrary URLs there, open the returned plan URL\n   automatically for convenient review \u2014 a convenience and smoke test, never the\n   only handoff or the access\n   model. Plans should load out of the box for the local agent and local browser\n   session; if a signed-in embedded browser cannot read a local plan that an\n   anonymous/tool check can read, fix the app/action ownership or access path\n   rather than patching one plan by hand. For high-stakes plans (architecture,\n   backend, data, multi-file, or risky), also kick off the self-review pass in\n   **Self-Review Before Handoff** while the user reads, instead of blocking the\n   handoff on it.\n5. For hosted plans, call `get-plan-feedback` before editing, after review,\n   after any long pause,\n   and before the final response. Treat `anchorDetails`, resolver intent, recent\n   review events, and any focused screenshots from browser handoff as the source\n   of truth for exactly what changed and exactly what each comment points at.\n6. For hosted plans, apply changes with `update-visual-plan`, preferring\n   targeted `contentPatches`.\n   Treat the top-level `content` payload as a full replacement, not a merge; do\n   not send a partial `content` object to add a canvas or one block. If a full\n   replacement or `replace-blocks` is unavoidable, call `get-visual-plan`\n   immediately before the write, pass its `plan.updatedAt` as\n   `expectedUpdatedAt`, and carry forward every existing block and visual\n   surface. Never reuse a revision from an earlier read or feedback payload.\n   For source-control friendly edits, use granular `patch-visual-plan-source`\n   operations against the MDX files instead of regenerating the plan;\n   `replace-file` is also destructive and requires the same fresh\n   `expectedUpdatedAt` fence.\n7. After every hosted-plan write, call `get-visual-plan` again and compare the\n   persisted text, block IDs/counts, canvas frames, and prototype with the\n   intended result. A successful mutation response is not proof that unrelated\n   content survived. If the edit addressed agent-targeted feedback, only after\n   this verification call `resolve-plan-comment` for the thread and\n   `consume-plan-feedback` for its comments; do both so addressed feedback is\n   neither visibly open nor returned as pending work.\n8. For hosted plans, export with `export-visual-plan` only when the user wants a\n   shareable receipt or repo-check-in artifacts.\n\n## Self-Review Before Handoff\n\nThis adversarial self-review pass is opt-in, not default: run it only for\nhigh-stakes plans \u2014 irreversible migrations, security-sensitive work, or when\nthe user explicitly asks for extra rigor \u2014 and skip it otherwise. It roughly\ndoubles the cost of plan generation, so the default for small, UI-only,\nsingle-decision, or ordinary plans is to skip it, not to run it. Keep the pass\ncheap and non-blocking when it does run:\n\n- **Surface the plan first, review concurrently.** Post the link and let the user\n  start reading, then run the review in parallel \u2014 never make the user wait on it.\n- **Review the written plan; do not re-research.** Critique the plan text and its\n  own blocks. The grounding was already done while drafting, so the review checks\n  the output instead of re-exploring the repo.\n- **Spawn one skeptical reviewer** whose only job is to find what is weak, missing,\n  or wrong \u2014 not to praise. Point it at: hard-to-reverse decisions made implicitly\n  or not at all (wire format, public ids, data-model shape, auth, ownership); steps\n  not anchored in real files or symbols; a menu of options where the plan should\n  commit to one; obvious missing decisions (\"what happens when X?\", \"why not Y?\");\n  and padding or single-step filler.\n- **Fix vs. ask.** Apply clear-cut fixes yourself with `update-visual-plan`\n  `contentPatches` \u2014 vague non-goals, unanchored claims, an obvious missing\n  decision. Route genuine judgment calls back to the user instead: add them to the\n  bottom `question-form` Open Questions block or batch them into the normal\n  ask-user-question flow. Do not silently decide them.\n- **Do not surprise the user mid-read.** On a large plan, apply the patches before\n  the editor loads; otherwise note briefly that a self-review is running so the\n  plan changing under them is expected. When you next respond, summarize what the\n  review changed and what it surfaced for the user to decide.\n\n## Visual Surface Choice\n\nChoose the surface before creating the plan or after reading the source plan. Do\nnot add visual chrome by default:\n\nFor UI/product plans, the top canvas is usually the primary review surface. Put\nthe first meaningful wireframes there, not buried as document-body blocks. Use\nmultiple canvas artboards when states matter, such as the default view, an\noverflow menu or popover, a side panel, loading, or error. Put short annotations\nbeside frames with `targetId` plus `placement`; keep implementation details,\ntradeoffs, file maps, data contracts, risks, and verification in the document\nbody below the canvas.\n\nWhen the user asks for a flow, storyboard, journey, wireframe, canvas, or \"what\nthis looks like\", treat that as a canvas-first request. Make one artboard per\nuser-visible state, connect only adjacent transitions, and use short canvas\nannotations for the product notes. Do not substitute a document-body `diagram`\nblock for the requested storyboard just because HTML diagrams are faster to\nwrite; diagrams belong below the canvas for backend mechanics, architecture, or\ndata-flow explanation.\n\nKeep product wireframes and explanatory/meta diagrams separate. Start with pure\nscreens that look like the app state under discussion, without callout prose or\narchitecture notes embedded inside the UI. Put arrows, labels, contracts, data\nflow, and mode explanations in separate annotations, separate canvas diagrams,\nor the document body.\n\nWhen the plan touches an existing app, inspect the current shell/components\nbefore drawing. The first artboard should look like the real app at the same\ndensity: existing sidebars, toolbar placement, overflow menus, app chrome, and\nframework agent chrome stay in their real places. Model secondary surfaces as\nseparate states, such as a top-right overflow popover, sheet, panel, loading\nstate, or separate AgentSidebar, rather than inventing a permanent inspector or\nfolding framework chrome into the product UI.\n\n- **No visual surface** for architecture-only, backend-only, data migration,\n  copy-only, or otherwise non-visual plans. Do not use the top canvas for\n  architecture diagrams, dependency maps, file plans, API contracts, or\n  data-flow-only reviews. Use a strong document with local inline diagrams\n  only when relationships need a visual explanation, usually one spatial diagram\n  per recommendation or decision. Prefer grouped regions, layers, quadrants,\n  matrices, or before/after panels over a single-axis chain unless the\n  relationship is truly sequential.\n- **Canvas only** for one static screen, a before/after comparison, a component\n  state, a small popover, or a visual direction that does not require clicking.\n  Put those wireframes in `content.canvas` and omit `content.prototype`.\n- **Canvas + prototype** for multi-step UI flows, onboarding, wizards,\n  review/approval flows, navigation changes, or anything where the reviewer\n  needs to operate the behavior. Keep the static wireframes in\n  `content.canvas`, add the aligned functional prototype in\n  `content.prototype`, and rely on the top visual tabs to switch between them.\n- **Prototype-first** when the user asks to operate the UI or when interaction is\n  the main question. Use `create-prototype-plan`, which still preserves static\n  mocks where useful.\n\nFor mixed canvas + prototype plans, reuse the same real labels, app statuses,\nand screen ids across both surfaces. The canvas is the inspectable static reference;\nthe prototype is the interactive version of that same flow, not a separate\ndesign direction.\n\n## Wireframe quality \u2014 read `references/wireframe.md`\n\nUI recap/plan wireframes must meet a strict quality bar \u2014 full-width chrome,\npinned bottom bars, real product content, before/after comparability, the right\n`surface` preset, `--wf-*` tokens instead of hex, and no `<html>`/`<style>`/font\ntags. Before authoring ANY wireframe / `<Screen>` / `WireframeBlock`, READ\n`references/wireframe.md` in this skill directory \u2014 it is the single source of\ntruth for HTML wireframe quality, shared word for word with `/visual-plan`\nand `/visual-recap`. Do not author wireframes from memory.\n\n## Canvas \u2014 read `references/canvas.md`\n\nThe canvas is the single source of truth for static UI mockups: the `surface`\nlocks each artboard's footprint, mixed surfaces lay out\nin lanes, annotations are plain-text designer notes anchored by\n`targetId`/`placement`, and edits are surgical `contentPatches`. Before\nauthoring or editing ANY canvas, artboard, or annotation, READ\n`references/canvas.md` in this skill directory \u2014 it is the single source of truth\nfor canvas/artboard mechanics. Do not author canvas layouts from memory.\nCanvas artboards use the same HTML wireframe path as document-body\n`WireframeBlock` screens: author `<Screen surface=\"...\" html={...} />` with a\nsemantic HTML fragment. Do not author fresh kit-tree children such as\n`<FrameScreen>`, `<Card>`, `<Row>`, or `<Btn>` inside canvas `<Screen>` tags;\nthose are legacy compatibility markup for old plans and produce brittle canvas\nlayouts.\n\n## Document quality \u2014 read `references/document-quality.md`\n\nThe document is a serious technical plan, not marketing: outcome-first,\nprose-first, self-contained, built from the right native blocks, with open\nquestions in a single bottom `question-form` and a pre-handoff visual check.\nBefore authoring the plan document, READ `references/document-quality.md` in this\nskill directory \u2014 it is the single source of truth for the document quality bar.\nDo not write the document from memory.\n\n## Good vs. bad exemplar \u2014 read `references/exemplar.md`\n\nFor a worked example of the bar \u2014 a great UI-first plan and `/visual-plan`, plus\nthe anti-patterns to avoid \u2014 READ `references/exemplar.md` in this skill\ndirectory before authoring a plan.\n\n## Tool Guidance\n\n- `create-visual-plan`: start one structured visual plan per agent task/run, or\n  import an existing text plan by passing `planText`; `content` may include no\n  visual surface, canvas only, or canvas + prototype.\n- `create-ui-plan`: start a UI-first plan when the work is primarily product UI.\n- `create-prototype-plan`: start a prototype-first plan with a functional top\n  review surface.\n- `create-plan-design`: start a full-fidelity branded Design-tab plan with an\n  optional matching Prototype tab.\n- `convert-visual-plan-to-prototype`: convert an existing HTML wireframe canvas\n  into a prototype plan.\n- `create-visual-questions`: use only when the user explicitly asks for a visual\n  intake questionnaire, not as `/visual-plan` preflight.\n- `update-visual-plan`: revise content, status, or comments with targeted\n  `contentPatches` (see Core Workflow steps 6-7). `replace-blocks` and full\n  `content` replacement require `expectedUpdatedAt` from a fresh\n  `get-visual-plan` call.\n- `read-visual-plan-source`: read the normalized plan as `plan.mdx`,\n  optional `canvas.mdx`, optional `.plan-state.json`, and JSON.\n- `patch-visual-plan-source`: apply granular MDX AST patches by stable block,\n  artboard, annotation, component, or wireframe-node id. Prefer those targeted\n  operations; `replace-file` requires `expectedUpdatedAt` from a fresh\n  `get-visual-plan` call.\n- `import-visual-plan-source`: create or replace a plan from an MDX folder.\n- `get-visual-plan`: read the current structured plan, exported HTML,\n  annotations, and `plan.updatedAt`; it also returns the MDX folder for source\n  workflows. Re-read immediately before a destructive write for its concurrency\n  fence and again after every write to verify persisted state.\n- `get-plan-feedback`: read unconsumed human feedback. Use it frequently; it\n  returns grouped threads, exact anchor details, expected resolver, and recent\n  review-event payloads so agents can act only on the comments meant for them.\n- `get-plan-blocks`: resolve block tags before authoring \u2014 do not memorize tags;\n  call this first to get the authoritative tag names, required fields, and prop\n  shapes from the live block registry.\n- `export-visual-plan`: export HTML, Markdown fallback, structured JSON, and MDX\n  files for repo check-in.\n\nWhen the user critiques a plan's look or structure, fix the renderer or this\nskill \u2014 never hand-edit one stored plan. Turn feedback into better guidance.\n\n## Local-Files Privacy Mode \u2014 read `references/local-files.md`\n\nWhen the user wants no hosted Plan database writes \u2014 no DB writes, no Plan MCP\npublish, fully local/offline/private planning, repo-owned source-controlled\nartifacts, or `AGENT_NATIVE_PLANS_MODE=local-files` \u2014 do not call any hosted Plan\ntool except the schema-only `get-plan-blocks` catalog lookup. Author a local MDX\nfolder and\npreview it with `plan local check` / `plan local serve` / `plan local verify`.\nBefore using local-files mode, READ `references/local-files.md` in this skill\ndirectory \u2014 it is the single source of truth for the full contract (catalog\nlookup, MDX folder layout, the local bridge commands, and the hosted tools you\nmust not call). Carry forward only the code-research and plan-composition\nguidance from Core Workflow; everything hosted is replaced by the local bridge.\n\n## Interpreting comment anchors\n\nThis section applies to hosted plans with `get-plan-feedback` /\n`update-visual-plan`. In local-files mode, do not call hosted feedback or update\ntools; interpret file/chat feedback directly, edit the MDX files, rerun the\nlocal bridge check/serve/verify command, and report the new local URL.\n\n`get-plan-feedback` returns rich anchors \u2014 read them before acting on any comment.\n\n- **Coordinate frames.** `targetX`/`targetY` are percentages *within* the\n  element named by `targetSelector`/`targetKind`. Bare `x`/`y` are percentages\n  of the whole plan document. `canvasX`/`canvasY` are raw board-world pixels on\n  the design canvas (board size given when available).\n- **Wireframe pins.** Anchors on wireframes include `targetNodeId` and\n  `targetNodePath` (e.g. `card > list > listItem \"Acme Inc\"`) identifying the\n  exact kit node. Use `targetNodeId` directly with wireframe node patch ops;\n  use `data-design-id` values from design artboards with\n  `update-design-element-style`. Prefer the node id/path over raw coordinates;\n  fall back to coordinates plus the focused screenshot (red ring marks the exact\n  point) only when no node id is present.\n- **Text quotes.** Resolve `textQuote` against current prose using\n  `contextBefore`/`contextAfter` for disambiguation. If `ambiguous: true`, ask\n  the user \u2014 do not guess which occurrence is meant.\n- **Detached comments.** `get-plan-feedback` flags threads whose quoted text no\n  longer exists as `detached` (in `detachedThreads`). Reconcile these against\n  rewritten content \u2014 never silently drop them.\n- **Routing.** `resolutionTarget` is the only routing signal: act on `agent`,\n  treat `human` as context only. `@mentions` are people to notify, never a\n  routing signal.\n- **Two-axis state.** Mark every ingested comment as consumed\n  (`consumedCommentIds` on `update-visual-plan`). Set `status=resolved` only on\n  agent-targeted comments you actually addressed; leave human-targeted comments\n  open. When an edit addresses feedback, first re-read the persisted plan and\n  verify the requested change. Only then call `resolve-plan-comment` for the\n  addressed thread and `consume-plan-feedback` for its comments; never mark\n  addressed feedback along only one axis.\n\n## Visibility & Sharing\n\nUse `set-resource-visibility` to change who can see a plan (e.g. public, login,\nor org-scoped). Use `share-resource` to grant specific users or roles access\nby email or role. Gate visibility before sharing any plan that covers\nunreleased or private work \u2014 default to the narrowest scope that meets the\nreview need.\n\n## Setup & Authentication\n\nThere are two ways into Plans.\n\n**Coding agent (CLI).** Install once with the Agent-Native CLI. The command\ninstalls the Plans skills, registers the hosted Plans MCP connector, and runs\nauth/setup for the selected local client(s) in the same step (a one-time browser\nsign-in at setup \u2014 this is intended), so the first tool call in that client does\nnot hit an OAuth wall:\n\n```bash\nnpx @agent-native/core@latest skills add visual-plans\n```\n\nAfter that, `/visual-plan`, `/visual-recap`, and `/visualize-repo` are the\ninstalled slash commands. If you only need one command, use\n`skills add visual-plan`, `skills add visual-recap`, or\n`skills add visualize-repo` instead. The other planning modes\n(`create-ui-plan`, `create-prototype-plan`, `create-plan-design`,\n`create-visual-questions`) are MCP tools reachable from `/visual-plan`, not\nseparate slash commands. Pass `--no-connect` to register the connector without\nauthenticating, then run\n`npx @agent-native/core@latest connect https://plan.agent-native.com --client all`\nwhenever you are ready, or choose a narrower `--client`. Auth and MCP tool\nloading are per client config/session.\n\n**Browser (people you share with).** Open the Plans editor and create & edit\nwith no sign-up \u2014 you work as a guest. Sign in only when you want to save or\nshare; signing in claims the plans you made as a guest into your account.\n\nSharing and commenting require an account: public/shared plans are viewable by\nanyone with the link, but commenting on them needs an agent-native account.\n\nFor fully offline, no-account use, run the Plans app locally and sync plans to\nyour repo as MDX. This local mode is a separate advanced path, not the default\nhosted flow.\n\nFor repo-wide visual docs, run\n`npx @agent-native/core@latest visualize-repo --open` to create/update\n`agent-native.json`, seed `.agent-native/visual-docs/repo-overview`, and open\nthe local bridge.\n\nIf a Plans tool returns `needs auth`, `Unauthorized`, or `Session terminated`, do\nnot keep retrying it \u2014 stop and give the user the per-client reconnect step from\n`references/connection.md`, then continue once the connector is available.\n\nHosted default: connect `https://plan.agent-native.com/mcp`. Do\nnot put shared secrets in skill files.\n";
+export declare const VISUAL_PLANS_SKILL_MD = "---\nname: visual-plan\ndescription: >-\n  Turn ordinary text plans into rich interactive visual plans with diagrams,\n  file maps, annotated code, open questions, and UI/prototype review when\n  useful.\nmetadata:\n  visibility: exported\n---\n\n# Agent-Native Plans\n\nAgent-Native Plans is structured visual planning mode for coding agents. Build\nthe plan you would normally write in Markdown, but as a scannable document with\neditable blocks mixed in: inline diagrams, code snippets,\nopen questions, and an optional top visual review area (wireframe canvas, live\nprototype, or both in tabs). Architecture and backend plans stay document-only;\nUI and product plans start with the top canvas/prototype (the Visual Surface\nChoice section owns that rule).\n\n`/visual-plan` is the packaged command and main entry point. Choose the review\nmode from the task: UI-first when the work is primarily product UI and review\nshould start with screens, prototype-first when review should start with a\nfunctional live prototype, design-first when review needs full-fidelity branded\nscreens, or visual-intake when the user explicitly wants a questionnaire before\nplanning. When a Codex, Claude Code, Markdown, or pasted plan already exists,\n`/visual-plan` uses that source plan as the starting point and builds the review\nsurface from it instead of starting over.\n\n## When To Use\n\nCreate or adapt a visual plan whenever the plan would be better as a reviewable\nartifact than a chat paragraph. This includes modest work such as a single UI\nsurface with states, a small workflow, a before/after product change, or a\ncomponent/API/data-shape decision that needs alignment, plus larger multi-file,\nambiguous, long-running, risky, or UI-heavy work. Use it when architecture /\ndata flow / UI direction / options / open questions would benefit from inline\ndiagrams or structured blocks, when the user needs to react to a direction\nbefore you implement, or when an existing text plan needs a richer review\nsurface.\n\n## Plan Discipline\n\n- **Gate thoughtfully.** A visual plan is a richer review surface, not only a\n  tool for giant projects. Use it when the user needs to see, compare, comment\n  on, or approve a direction before code, even for a modest UI/state/workflow\n  change. Skip it for truly trivial, unambiguous work \u2014 typos, one-line fixes, a\n  single well-specified function, anything whose diff you could describe in one\n  sentence \u2014 and just make the change. Never pad a plan with filler and never\n  ship a single-step plan.\n- **Research before you draft.** Read the real files, actions, schema, and\n  patterns first; name actual files, symbols, and data shapes instead of\n  inventing them. Check existing `actions/` before proposing endpoints and prefer\n  named client helpers over raw fetch. Delegate wide exploration to a sub-agent.\n  Lead with reuse: for each step, name what it reuses \u2014 existing actions, schema,\n  components, helpers \u2014 before what it adds, so the plan explains the genuinely new\n  delta instead of redescribing what already exists.\n- **Decide the hard-to-reverse bets first.** For non-trivial backend, data, or API\n  work, sketch where the feature is headed, then call out the decisions that are\n  expensive to undo once data or callers depend on them \u2014 wire format, public ids,\n  data-model shape, auth and ownership boundaries \u2014 and get those right in the plan\n  even if most of the feature ships later. Then scope to the smallest first cut that\n  proves the approach without foreclosing it, stating both what is in and what is\n  explicitly deferred.\n- **Keep examples at the right altitude.** When the user's idea is a broad\n  framework, product, or operating-model change, do not collapse it into the\n  first concrete example, provider, or sync path they mention. Separate the core\n  abstraction from motivating examples and app/provider adapters. Use examples\n  to make the plan legible, but label them as examples unless they are the whole\n  requested scope.\n- **Publish standalone plans.** If the user pasted, referenced, or already has a\n  Codex / Claude Code / Markdown plan, treat it as source material, but rewrite\n  the published plan as a clean standalone proposal. Preserve the source plan's\n  useful intent and codebase facts, label inferred visuals as inferred, and avoid\n  revision language such as \"preserve the prior plan\", \"do not drop the old\n  idea\", \"unlike the previous version\", or \"this revision changes...\". A reader\n  who never saw the chat or earlier drafts should understand the plan.\n- **Make the first read concrete.** If the plan is meant to be shared with\n  someone outside the chat, or if the concept is abstract, lead near the top with\n  one concrete product example before mode tables, architecture, or roadmaps. For\n  UI-capable concepts, that usually means a top-canvas app state that shows the\n  real user workflow in product terms. Do not rely on phrases that only make\n  sense in conversation, and do not frame the plan as \"not the old idea\"; state\n  the positive model directly.\n- **Planning is read-only.** Make no source edits while building or reviewing the\n  plan. Start editing only after the user approves the direction.\n- **Clarify vs. assume.** Do not ask how to build it \u2014 explore and present the\n  approach and options in the plan. Ask a clarifying question only when an\n  ambiguity would change the design and you cannot resolve it from the code; use\n  the host agent's normal ask-user-question flow and batch 2-4 high-leverage\n  questions before finalizing. Do not call `create-visual-questions` for\n  ordinary clarification or preflight; reserve it for the visual-intake mode when\n  the user explicitly asks for a visual intake questionnaire. Otherwise state the\n  assumption explicitly and proceed, and keep anything unresolved in the plan's\n  single bottom `question-form` Open Questions block. For complex plans, do a\n  final open-question pass before handoff: if a decision would affect\n  architecture, scope, UX, data shape, or rollout, either decide it in the plan\n  with rationale or put it in that bottom form with a recommended default.\n- **The plan is the approval gate.** After surfacing it, ask the user to review\n  and approve before you write code, and name which files/areas the work touches.\n  Presenting the plan and requesting sign-off is the approval step \u2014 do not ask a\n  separate \"does this look good?\" question.\n- **The document is the source of truth, not the chat.** When scope shifts,\n  update the plan with `update-visual-plan` rather than only changing course in\n  chat, and make the updated document stand alone. Do not describe the update as\n  a correction to an earlier draft inside the plan itself. Re-read the approved\n  plan before major steps.\n\n## Create A Structured Agent-Native Plan \u2014 Never Inline\n\nThe deliverable is ALWAYS a structured Agent-Native Plan, not a chat-only plan.\nThe hosted Plan MCP connector (`plan` server, or legacy `agent-native-plans`) is\nthe default collaboration and commenting surface; it is not a reason to reject\nthe planning pattern as an external dependency or rented layer. Plans are\nportable source artifacts (`plan.mdx`, optional `canvas.mdx` /\n`prototype.mdx`, JSON, and HTML export), and ownership-sensitive workflows can\nuse local-files mode or a self-hosted/custom Plan app URL without abandoning the\nskill's review discipline. Do not advise the user to skip `/visual-plan` because\nthe default surface is hosted; choose the right Plan mode for the user's\nownership, privacy, sharing, and branding needs.\n\nBy default, create the plan via the Plan MCP connector and NEVER hand it over as\ninline chat content \u2014 no Markdown prose, ASCII sketch, table, or fenced\nwireframe. If the `plan` (or legacy `agent-native-plans`) tools are not visible,\ndiscover them through the host's `tool_search` first; if they are still missing,\nSTOP and give the user the client-specific reconnect step rather than improvising\nan inline plan. Before publishing, or whenever a connector or auth error appears,\nREAD `references/connection.md` in this skill directory \u2014 it is the single source\nof truth for the never-inline rule, connector discovery, and the per-client\nreconnect steps. Local-files privacy mode (after Tool Guidance) is the exception.\n\n## Core Workflow\n\nThis section describes the default hosted Plan MCP workflow. If\n`AGENT_NATIVE_PLANS_MODE=local-files` is set, or the user asks for fully local\nfiles/no hosted Plan writes, use **Local-Files Privacy Mode** instead; carry\nforward only the code-research and plan-composition guidance here.\n\n1. Follow the host agent's normal planning flow: inspect the codebase, delegate\n   wide exploration when useful, gather the info needed, and ask native\n   clarifying questions as needed before generating the plan. If a source plan\n   already exists, gather its exact text from the user's paste, a referenced\n   file, or recent visible agent context; do not invent source text.\n2. Call `get-plan-blocks` for the authoritative block catalog \u2014 do not author\n   from memorized tags. Then call the mode-matched create tool:\n   `create-visual-plan` for document-first plans (architecture, backend, data,\n   refactor, API), `create-ui-plan` for UI-first plans, `create-prototype-plan`\n   for prototype-first plans, `create-plan-design` for design-first plans,\n   `create-visual-questions` only when the user explicitly asks for a visual\n   intake questionnaire. When a source plan already exists,\n   pass it as `planText` and preserve the original plan's useful intent while\n   producing a standalone plan document, not a revision memo.\n3. For UI/product plans, compose the top canvas first with the primary\n   wireframes and annotated states, then write the document with native blocks\n   (see `references/canvas.md` and `references/document-quality.md`). For\n   broad product architecture plans with a user-facing implication, add a\n   concrete \"what this looks like in the app\" visual before the abstract\n   architecture or mode tables. Keep the document close to the standalone\n   Markdown plan the agent would normally output. If an existing plan was\n   provided, carry forward the right facts and decisions without referring to\n   the previous draft or explaining how this version differs. For non-visual\n   plans, skip the top visual surface (Visual Surface Choice below owns the rule)\n   and put `diagram`, `data-model`,\n   `api-endpoint`, `diff`, `file-tree`, `code`, and `annotated-code` blocks\n   directly next to the relevant prose.\n   Wide document layout is renderer-owned and intentionally allowlisted: only\n   literal code-review surfaces (`diff`, `annotated-code`) and `tabs` blocks\n   with vertical orientation or diff-like children break out wider than prose.\n   Keep `api-endpoint`, `openapi-spec`, `data-model`, `json-explorer`,\n   `wireframe`, question, and `custom-html` blocks in normal document flow unless\n   their own renderer says otherwise.\n4. Surface the returned Plans link or inline MCP App and ask the user to review.\n   Always include the actual URL in chat so the next step is a click in CLI or\n   other text-only hosts. When the host exposes an embedded browser/preview panel\n   and a tool can open arbitrary URLs there, open the returned plan URL\n   automatically for convenient review \u2014 a convenience and smoke test, never the\n   only handoff or the access\n   model. Plans should load out of the box for the local agent and local browser\n   session; if a signed-in embedded browser cannot read a local plan that an\n   anonymous/tool check can read, fix the app/action ownership or access path\n   rather than patching one plan by hand. For high-stakes plans (architecture,\n   backend, data, multi-file, or risky), also kick off the self-review pass in\n   **Self-Review Before Handoff** while the user reads, instead of blocking the\n   handoff on it.\n5. For hosted plans, call `get-plan-feedback` before editing, after review,\n   after any long pause,\n   and before the final response. Treat `anchorDetails`, resolver intent, recent\n   review events, and any focused screenshots from browser handoff as the source\n   of truth for exactly what changed and exactly what each comment points at.\n6. For hosted plans, apply changes with `update-visual-plan`, preferring\n   targeted `contentPatches`.\n   Treat the top-level `content` payload as a full replacement, not a merge; do\n   not send a partial `content` object to add a canvas or one block. If a full\n   replacement or `replace-blocks` is unavoidable, call `get-visual-plan`\n   immediately before the write, pass its `plan.updatedAt` as\n   `expectedUpdatedAt`, and carry forward every existing block and visual\n   surface. Never reuse a revision from an earlier read or feedback payload.\n   For source-control friendly edits, use granular `patch-visual-plan-source`\n   operations against the MDX files instead of regenerating the plan;\n   `replace-file` is also destructive and requires the same fresh\n   `expectedUpdatedAt` fence.\n7. After every hosted-plan write, call `get-visual-plan` again and compare the\n   persisted text, block IDs/counts, canvas frames, and prototype with the\n   intended result. A successful mutation response is not proof that unrelated\n   content survived. If the edit addressed agent-targeted feedback, only after\n   this verification call `resolve-plan-comment` for the thread and\n   `consume-plan-feedback` for its comments; do both so addressed feedback is\n   neither visibly open nor returned as pending work.\n8. For hosted plans, export with `export-visual-plan` only when the user wants a\n   shareable receipt or repo-check-in artifacts.\n\n## Self-Review Before Handoff\n\nThis adversarial self-review pass is opt-in, not default: run it only for\nhigh-stakes plans \u2014 irreversible migrations, security-sensitive work, or when\nthe user explicitly asks for extra rigor \u2014 and skip it otherwise. It roughly\ndoubles the cost of plan generation, so the default for small, UI-only,\nsingle-decision, or ordinary plans is to skip it, not to run it. Keep the pass\ncheap and non-blocking when it does run:\n\n- **Surface the plan first, review concurrently.** Post the link and let the user\n  start reading, then run the review in parallel \u2014 never make the user wait on it.\n- **Review the written plan; do not re-research.** Critique the plan text and its\n  own blocks. The grounding was already done while drafting, so the review checks\n  the output instead of re-exploring the repo.\n- **Spawn one skeptical reviewer** whose only job is to find what is weak, missing,\n  or wrong \u2014 not to praise. Point it at: hard-to-reverse decisions made implicitly\n  or not at all (wire format, public ids, data-model shape, auth, ownership); steps\n  not anchored in real files or symbols; a menu of options where the plan should\n  commit to one; obvious missing decisions (\"what happens when X?\", \"why not Y?\");\n  and padding or single-step filler.\n- **Fix vs. ask.** Apply clear-cut fixes yourself with `update-visual-plan`\n  `contentPatches` \u2014 vague non-goals, unanchored claims, an obvious missing\n  decision. Route genuine judgment calls back to the user instead: add them to the\n  bottom `question-form` Open Questions block or batch them into the normal\n  ask-user-question flow. Do not silently decide them.\n- **Do not surprise the user mid-read.** On a large plan, apply the patches before\n  the editor loads; otherwise note briefly that a self-review is running so the\n  plan changing under them is expected. When you next respond, summarize what the\n  review changed and what it surfaced for the user to decide.\n\n## Visual Surface Choice\n\nChoose the surface before creating the plan or after reading the source plan. Do\nnot add visual chrome by default:\n\nFor UI/product plans, the top canvas is usually the primary review surface. Put\nthe first meaningful wireframes there, not buried as document-body blocks. Use\nmultiple canvas artboards when states matter, such as the default view, an\noverflow menu or popover, a side panel, loading, or error. Put short annotations\nbeside frames with `targetId` plus `placement`; keep implementation details,\ntradeoffs, file maps, data contracts, risks, and verification in the document\nbody below the canvas.\n\nWhen the user asks for a flow, storyboard, journey, wireframe, canvas, or \"what\nthis looks like\", treat that as a canvas-first request. Make one artboard per\nuser-visible state, connect only adjacent transitions, and use short canvas\nannotations for the product notes. Do not substitute a document-body `diagram`\nblock for the requested storyboard just because HTML diagrams are faster to\nwrite; diagrams belong below the canvas for backend mechanics, architecture, or\ndata-flow explanation.\n\nKeep product wireframes and explanatory/meta diagrams separate. Start with pure\nscreens that look like the app state under discussion, without callout prose or\narchitecture notes embedded inside the UI. Put arrows, labels, contracts, data\nflow, and mode explanations in separate annotations, separate canvas diagrams,\nor the document body.\n\nWhen the plan touches an existing app, inspect the current shell/components\nbefore drawing. The first artboard should look like the real app at the same\ndensity: existing sidebars, toolbar placement, overflow menus, app chrome, and\nframework agent chrome stay in their real places. Model secondary surfaces as\nseparate states, such as a top-right overflow popover, sheet, panel, loading\nstate, or separate AgentSidebar, rather than inventing a permanent inspector or\nfolding framework chrome into the product UI.\n\n- **No visual surface** for architecture-only, backend-only, data migration,\n  copy-only, or otherwise non-visual plans. Do not use the top canvas for\n  architecture diagrams, dependency maps, file plans, API contracts, or\n  data-flow-only reviews. Use a strong document with local inline diagrams\n  only when relationships need a visual explanation, usually one spatial diagram\n  per recommendation or decision. Prefer grouped regions, layers, quadrants,\n  matrices, or before/after panels over a single-axis chain unless the\n  relationship is truly sequential.\n- **Canvas only** for one static screen, a before/after comparison, a component\n  state, a small popover, or a visual direction that does not require clicking.\n  Put those wireframes in `content.canvas` and omit `content.prototype`.\n- **Canvas + prototype** for multi-step UI flows, onboarding, wizards,\n  review/approval flows, navigation changes, or anything where the reviewer\n  needs to operate the behavior. Keep the static wireframes in\n  `content.canvas`, add the aligned functional prototype in\n  `content.prototype`, and rely on the top visual tabs to switch between them.\n  When both surfaces are present, open the Wireframes tab by default; the\n  prototype remains available as the interactive follow-up view.\n- **Prototype-first** when the user asks to operate the UI or when interaction is\n  the main question. Use `create-prototype-plan`, which still preserves static\n  mocks where useful.\n\nFor mixed canvas + prototype plans, reuse the same real labels, app statuses,\nand screen ids across both surfaces. The canvas is the inspectable static reference;\nthe prototype is the interactive version of that same flow, not a separate\ndesign direction.\n\n## Wireframe quality \u2014 read `references/wireframe.md`\n\nUI recap/plan wireframes must meet a strict quality bar \u2014 full-width chrome,\npinned bottom bars, real product content, before/after comparability, the right\n`surface` preset, `--wf-*` tokens instead of hex, and no `<html>`/`<style>`/font\ntags. Before authoring ANY wireframe / `<Screen>` / `WireframeBlock`, READ\n`references/wireframe.md` in this skill directory \u2014 it is the single source of\ntruth for HTML wireframe quality, shared word for word with `/visual-plan`\nand `/visual-recap`. Do not author wireframes from memory.\n\n## Canvas \u2014 read `references/canvas.md`\n\nThe canvas is the single source of truth for static UI mockups: the `surface`\nlocks each artboard's footprint, mixed surfaces lay out\nin lanes, annotations are plain-text designer notes anchored by\n`targetId`/`placement`, and edits are surgical `contentPatches`. Before\nauthoring or editing ANY canvas, artboard, or annotation, READ\n`references/canvas.md` in this skill directory \u2014 it is the single source of truth\nfor canvas/artboard mechanics. Do not author canvas layouts from memory.\nCanvas artboards use the same HTML wireframe path as document-body\n`WireframeBlock` screens: author `<Screen surface=\"...\" html={...} />` with a\nsemantic HTML fragment. Do not author fresh kit-tree children such as\n`<FrameScreen>`, `<Card>`, `<Row>`, or `<Btn>` inside canvas `<Screen>` tags;\nthose are legacy compatibility markup for old plans and produce brittle canvas\nlayouts.\n\n## Document quality \u2014 read `references/document-quality.md`\n\nThe document is a serious technical plan, not marketing: outcome-first,\nprose-first, self-contained, built from the right native blocks, with open\nquestions in a single bottom `question-form` and a pre-handoff visual check.\nBefore authoring the plan document, READ `references/document-quality.md` in this\nskill directory \u2014 it is the single source of truth for the document quality bar.\nDo not write the document from memory.\n\n## Good vs. bad exemplar \u2014 read `references/exemplar.md`\n\nFor a worked example of the bar \u2014 a great UI-first plan and `/visual-plan`, plus\nthe anti-patterns to avoid \u2014 READ `references/exemplar.md` in this skill\ndirectory before authoring a plan.\n\n## Tool Guidance\n\n- `create-visual-plan`: start one structured visual plan per agent task/run, or\n  import an existing text plan by passing `planText`; `content` may include no\n  visual surface, canvas only, or canvas + prototype.\n- `create-ui-plan`: start a UI-first plan when the work is primarily product UI.\n- `create-prototype-plan`: start a prototype-first plan with a functional top\n  review surface.\n- `create-plan-design`: start a full-fidelity branded Design-tab plan with an\n  optional matching Prototype tab.\n- `convert-visual-plan-to-prototype`: convert an existing HTML wireframe canvas\n  into a prototype plan.\n- `create-visual-questions`: use only when the user explicitly asks for a visual\n  intake questionnaire, not as `/visual-plan` preflight.\n- `update-visual-plan`: revise content, status, or comments with targeted\n  `contentPatches` (see Core Workflow steps 6-7). `replace-blocks` and full\n  `content` replacement require `expectedUpdatedAt` from a fresh\n  `get-visual-plan` call.\n- `read-visual-plan-source`: read the normalized plan as `plan.mdx`,\n  optional `canvas.mdx`, optional `.plan-state.json`, and JSON.\n- `patch-visual-plan-source`: apply granular MDX AST patches by stable block,\n  artboard, annotation, component, or wireframe-node id. Prefer those targeted\n  operations; `replace-file` requires `expectedUpdatedAt` from a fresh\n  `get-visual-plan` call.\n- `import-visual-plan-source`: create or replace a plan from an MDX folder.\n- `get-visual-plan`: read the current structured plan, exported HTML,\n  annotations, and `plan.updatedAt`; it also returns the MDX folder for source\n  workflows. Re-read immediately before a destructive write for its concurrency\n  fence and again after every write to verify persisted state.\n- `get-plan-feedback`: read unconsumed human feedback. Use it frequently; it\n  returns grouped threads, exact anchor details, expected resolver, and recent\n  review-event payloads so agents can act only on the comments meant for them.\n- `get-plan-blocks`: resolve block tags before authoring \u2014 do not memorize tags;\n  call this first to get the authoritative tag names, required fields, and prop\n  shapes from the live block registry.\n- `export-visual-plan`: export HTML, Markdown fallback, structured JSON, and MDX\n  files for repo check-in.\n\nWhen the user critiques a plan's look or structure, fix the renderer or this\nskill \u2014 never hand-edit one stored plan. Turn feedback into better guidance.\n\n## Local-Files Privacy Mode \u2014 read `references/local-files.md`\n\nWhen the user wants no hosted Plan database writes \u2014 no DB writes, no Plan MCP\npublish, fully local/offline/private planning, repo-owned source-controlled\nartifacts, or `AGENT_NATIVE_PLANS_MODE=local-files` \u2014 do not call any hosted Plan\ntool except the schema-only `get-plan-blocks` catalog lookup. Author a local MDX\nfolder and\npreview it with `plan local check` / `plan local serve` / `plan local verify`.\nBefore using local-files mode, READ `references/local-files.md` in this skill\ndirectory \u2014 it is the single source of truth for the full contract (catalog\nlookup, MDX folder layout, the local bridge commands, and the hosted tools you\nmust not call). Carry forward only the code-research and plan-composition\nguidance from Core Workflow; everything hosted is replaced by the local bridge.\n\n## Interpreting comment anchors\n\nThis section applies to hosted plans with `get-plan-feedback` /\n`update-visual-plan`. In local-files mode, do not call hosted feedback or update\ntools; interpret file/chat feedback directly, edit the MDX files, rerun the\nlocal bridge check/serve/verify command, and report the new local URL.\n\n`get-plan-feedback` returns rich anchors \u2014 read them before acting on any comment.\n\n- **Coordinate frames.** `targetX`/`targetY` are percentages *within* the\n  element named by `targetSelector`/`targetKind`. Bare `x`/`y` are percentages\n  of the whole plan document. `canvasX`/`canvasY` are raw board-world pixels on\n  the design canvas (board size given when available).\n- **Wireframe pins.** Anchors on wireframes include `targetNodeId` and\n  `targetNodePath` (e.g. `card > list > listItem \"Acme Inc\"`) identifying the\n  exact kit node. Use `targetNodeId` directly with wireframe node patch ops;\n  use `data-design-id` values from design artboards with\n  `update-design-element-style`. Prefer the node id/path over raw coordinates;\n  fall back to coordinates plus the focused screenshot (red ring marks the exact\n  point) only when no node id is present.\n- **Text quotes.** Resolve `textQuote` against current prose using\n  `contextBefore`/`contextAfter` for disambiguation. If `ambiguous: true`, ask\n  the user \u2014 do not guess which occurrence is meant.\n- **Detached comments.** `get-plan-feedback` flags threads whose quoted text no\n  longer exists as `detached` (in `detachedThreads`). Reconcile these against\n  rewritten content \u2014 never silently drop them.\n- **Routing.** `resolutionTarget` is the only routing signal: act on `agent`,\n  treat `human` as context only. `@mentions` are people to notify, never a\n  routing signal.\n- **Two-axis state.** Mark every ingested comment as consumed\n  (`consumedCommentIds` on `update-visual-plan`). Set `status=resolved` only on\n  agent-targeted comments you actually addressed; leave human-targeted comments\n  open. When an edit addresses feedback, first re-read the persisted plan and\n  verify the requested change. Only then call `resolve-plan-comment` for the\n  addressed thread and `consume-plan-feedback` for its comments; never mark\n  addressed feedback along only one axis.\n\n## Visibility & Sharing\n\nUse `set-resource-visibility` to change who can see a plan (e.g. public, login,\nor org-scoped). Use `share-resource` to grant specific users or roles access\nby email or role. Gate visibility before sharing any plan that covers\nunreleased or private work \u2014 default to the narrowest scope that meets the\nreview need.\n\n## Setup & Authentication\n\nThere are two ways into Plans.\n\n**Coding agent (CLI).** Install once with the Agent-Native CLI. The command\ninstalls the Plans skills, registers the hosted Plans MCP connector, and runs\nauth/setup for the selected local client(s) in the same step (a one-time browser\nsign-in at setup \u2014 this is intended), so the first tool call in that client does\nnot hit an OAuth wall:\n\n```bash\nnpx @agent-native/core@latest skills add visual-plans\n```\n\nAfter that, `/visual-plan`, `/visual-recap`, and `/visualize-repo` are the\ninstalled slash commands. If you only need one command, use\n`skills add visual-plan`, `skills add visual-recap`, or\n`skills add visualize-repo` instead. The other planning modes\n(`create-ui-plan`, `create-prototype-plan`, `create-plan-design`,\n`create-visual-questions`) are MCP tools reachable from `/visual-plan`, not\nseparate slash commands. Pass `--no-connect` to register the connector without\nauthenticating, then run\n`npx @agent-native/core@latest connect https://plan.agent-native.com --client all`\nwhenever you are ready, or choose a narrower `--client`. Auth and MCP tool\nloading are per client config/session.\n\n**Browser (people you share with).** Open the Plans editor and create & edit\nwith no sign-up \u2014 you work as a guest. Sign in only when you want to save or\nshare; signing in claims the plans you made as a guest into your account.\n\nSharing and commenting require an account: public/shared plans are viewable by\nanyone with the link, but commenting on them needs an agent-native account.\n\nFor fully offline, no-account use, run the Plans app locally and sync plans to\nyour repo as MDX. This local mode is a separate advanced path, not the default\nhosted flow.\n\nFor repo-wide visual docs, run\n`npx @agent-native/core@latest visualize-repo --open` to create/update\n`agent-native.json`, seed `.agent-native/visual-docs/repo-overview`, and open\nthe local bridge.\n\nIf a Plans tool returns `needs auth`, `Unauthorized`, or `Session terminated`, do\nnot keep retrying it \u2014 stop and give the user the per-client reconnect step from\n`references/connection.md`, then continue once the connector is available.\n\nHosted default: connect `https://plan.agent-native.com/mcp`. Do\nnot put shared secrets in skill files.\n";
 //# sourceMappingURL=visual-plan-skill.d.ts.map

package/dist/cli/skills-content/visual-plan-skill.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"visual-plan-skill.d.ts","sourceRoot":"","sources":["../../../src/cli/skills-content/visual-plan-skill.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB~~,+j7BA0ejC~~,CAAC"}
1	+ {"version":3,"file":"visual-plan-skill.d.ts","sourceRoot":"","sources":["../../../src/cli/skills-content/visual-plan-skill.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,4s7BA4ejC,CAAC"}

package/dist/cli/skills-content/visual-plan-skill.js CHANGED Viewed

@@ -290,6 +290,8 @@ folding framework chrome into the product UI.
   needs to operate the behavior. Keep the static wireframes in
   \`content.canvas\`, add the aligned functional prototype in
   \`content.prototype\`, and rely on the top visual tabs to switch between them.
+  When both surfaces are present, open the Wireframes tab by default; the
+  prototype remains available as the interactive follow-up view.
 - **Prototype-first** when the user asks to operate the UI or when interaction is
   the main question. Use \`create-prototype-plan\`, which still preserves static
   mocks where useful.

package/dist/cli/skills-content/visual-plan-skill.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"visual-plan-skill.js","sourceRoot":"","sources":["../../../src/cli/skills-content/visual-plan-skill.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0epC,CAAC","sourcesContent":["export const VISUAL_PLANS_SKILL_MD = `---\nname: visual-plan\ndescription: >-\n Turn ordinary text plans into rich interactive visual plans with diagrams,\n file maps, annotated code, open questions, and UI/prototype review when\n useful.\nmetadata:\n visibility: exported\n---\n\n# Agent-Native Plans\n\nAgent-Native Plans is structured visual planning mode for coding agents. Build\nthe plan you would normally write in Markdown, but as a scannable document with\neditable blocks mixed in: inline diagrams, code snippets,\nopen questions, and an optional top visual review area (wireframe canvas, live\nprototype, or both in tabs). Architecture and backend plans stay document-only;\nUI and product plans start with the top canvas/prototype (the Visual Surface\nChoice section owns that rule).\n\n\\`/visual-plan\\` is the packaged command and main entry point. Choose the review\nmode from the task: UI-first when the work is primarily product UI and review\nshould start with screens, prototype-first when review should start with a\nfunctional live prototype, design-first when review needs full-fidelity branded\nscreens, or visual-intake when the user explicitly wants a questionnaire before\nplanning. When a Codex, Claude Code, Markdown, or pasted plan already exists,\n\\`/visual-plan\\` uses that source plan as the starting point and builds the review\nsurface from it instead of starting over.\n\n## When To Use\n\nCreate or adapt a visual plan whenever the plan would be better as a reviewable\nartifact than a chat paragraph. This includes modest work such as a single UI\nsurface with states, a small workflow, a before/after product change, or a\ncomponent/API/data-shape decision that needs alignment, plus larger multi-file,\nambiguous, long-running, risky, or UI-heavy work. Use it when architecture /\ndata flow / UI direction / options / open questions would benefit from inline\ndiagrams or structured blocks, when the user needs to react to a direction\nbefore you implement, or when an existing text plan needs a richer review\nsurface.\n\n## Plan Discipline\n\n- Gate thoughtfully. A visual plan is a richer review surface, not only a\n tool for giant projects. Use it when the user needs to see, compare, comment\n on, or approve a direction before code, even for a modest UI/state/workflow\n change. Skip it for truly trivial, unambiguous work — typos, one-line fixes, a\n single well-specified function, anything whose diff you could describe in one\n sentence — and just make the change. Never pad a plan with filler and never\n ship a single-step plan.\n- Research before you draft. Read the real files, actions, schema, and\n patterns first; name actual files, symbols, and data shapes instead of\n inventing them. Check existing \\`actions/\\` before proposing endpoints and prefer\n named client helpers over raw fetch. Delegate wide exploration to a sub-agent.\n Lead with reuse: for each step, name what it reuses — existing actions, schema,\n components, helpers — before what it adds, so the plan explains the genuinely new\n delta instead of redescribing what already exists.\n- Decide the hard-to-reverse bets first. For non-trivial backend, data, or API\n work, sketch where the feature is headed, then call out the decisions that are\n expensive to undo once data or callers depend on them — wire format, public ids,\n data-model shape, auth and ownership boundaries — and get those right in the plan\n even if most of the feature ships later. Then scope to the smallest first cut that\n proves the approach without foreclosing it, stating both what is in and what is\n explicitly deferred.\n- Keep examples at the right altitude. When the user's idea is a broad\n framework, product, or operating-model change, do not collapse it into the\n first concrete example, provider, or sync path they mention. Separate the core\n abstraction from motivating examples and app/provider adapters. Use examples\n to make the plan legible, but label them as examples unless they are the whole\n requested scope.\n- Publish standalone plans. If the user pasted, referenced, or already has a\n Codex / Claude Code / Markdown plan, treat it as source material, but rewrite\n the published plan as a clean standalone proposal. Preserve the source plan's\n useful intent and codebase facts, label inferred visuals as inferred, and avoid\n revision language such as \"preserve the prior plan\", \"do not drop the old\n idea\", \"unlike the previous version\", or \"this revision changes...\". A reader\n who never saw the chat or earlier drafts should understand the plan.\n- Make the first read concrete. If the plan is meant to be shared with\n someone outside the chat, or if the concept is abstract, lead near the top with\n one concrete product example before mode tables, architecture, or roadmaps. For\n UI-capable concepts, that usually means a top-canvas app state that shows the\n real user workflow in product terms. Do not rely on phrases that only make\n sense in conversation, and do not frame the plan as \"not the old idea\"; state\n the positive model directly.\n- Planning is read-only. Make no source edits while building or reviewing the\n plan. Start editing only after the user approves the direction.\n- Clarify vs. assume. Do not ask how to build it — explore and present the\n approach and options in the plan. Ask a clarifying question only when an\n ambiguity would change the design and you cannot resolve it from the code; use\n the host agent's normal ask-user-question flow and batch 2-4 high-leverage\n questions before finalizing. Do not call \\`create-visual-questions\\` for\n ordinary clarification or preflight; reserve it for the visual-intake mode when\n the user explicitly asks for a visual intake questionnaire. Otherwise state the\n assumption explicitly and proceed, and keep anything unresolved in the plan's\n single bottom \\`question-form\\` Open Questions block. For complex plans, do a\n final open-question pass before handoff: if a decision would affect\n architecture, scope, UX, data shape, or rollout, either decide it in the plan\n with rationale or put it in that bottom form with a recommended default.\n- The plan is the approval gate. After surfacing it, ask the user to review\n and approve before you write code, and name which files/areas the work touches.\n Presenting the plan and requesting sign-off is the approval step — do not ask a\n separate \"does this look good?\" question.\n- The document is the source of truth, not the chat. When scope shifts,\n update the plan with \\`update-visual-plan\\` rather than only changing course in\n chat, and make the updated document stand alone. Do not describe the update as\n a correction to an earlier draft inside the plan itself. Re-read the approved\n plan before major steps.\n\n## Create A Structured Agent-Native Plan — Never Inline\n\nThe deliverable is ALWAYS a structured Agent-Native Plan, not a chat-only plan.\nThe hosted Plan MCP connector (\\`plan\\` server, or legacy \\`agent-native-plans\\`) is\nthe default collaboration and commenting surface; it is not a reason to reject\nthe planning pattern as an external dependency or rented layer. Plans are\nportable source artifacts (\\`plan.mdx\\`, optional \\`canvas.mdx\\` /\n\\`prototype.mdx\\`, JSON, and HTML export), and ownership-sensitive workflows can\nuse local-files mode or a self-hosted/custom Plan app URL without abandoning the\nskill's review discipline. Do not advise the user to skip \\`/visual-plan\\` because\nthe default surface is hosted; choose the right Plan mode for the user's\nownership, privacy, sharing, and branding needs.\n\nBy default, create the plan via the Plan MCP connector and NEVER hand it over as\ninline chat content — no Markdown prose, ASCII sketch, table, or fenced\nwireframe. If the \\`plan\\` (or legacy \\`agent-native-plans\\`) tools are not visible,\ndiscover them through the host's \\`tool_search\\` first; if they are still missing,\nSTOP and give the user the client-specific reconnect step rather than improvising\nan inline plan. Before publishing, or whenever a connector or auth error appears,\nREAD \\`references/connection.md\\` in this skill directory — it is the single source\nof truth for the never-inline rule, connector discovery, and the per-client\nreconnect steps. Local-files privacy mode (after Tool Guidance) is the exception.\n\n## Core Workflow\n\nThis section describes the default hosted Plan MCP workflow. If\n\\`AGENT_NATIVE_PLANS_MODE=local-files\\` is set, or the user asks for fully local\nfiles/no hosted Plan writes, use Local-Files Privacy Mode instead; carry\nforward only the code-research and plan-composition guidance here.\n\n1. Follow the host agent's normal planning flow: inspect the codebase, delegate\n wide exploration when useful, gather the info needed, and ask native\n clarifying questions as needed before generating the plan. If a source plan\n already exists, gather its exact text from the user's paste, a referenced\n file, or recent visible agent context; do not invent source text.\n2. Call \\`get-plan-blocks\\` for the authoritative block catalog — do not author\n from memorized tags. Then call the mode-matched create tool:\n \\`create-visual-plan\\` for document-first plans (architecture, backend, data,\n refactor, API), \\`create-ui-plan\\` for UI-first plans, \\`create-prototype-plan\\`\n for prototype-first plans, \\`create-plan-design\\` for design-first plans,\n \\`create-visual-questions\\` only when the user explicitly asks for a visual\n intake questionnaire. When a source plan already exists,\n pass it as \\`planText\\` and preserve the original plan's useful intent while\n producing a standalone plan document, not a revision memo.\n3. For UI/product plans, compose the top canvas first with the primary\n wireframes and annotated states, then write the document with native blocks\n (see \\`references/canvas.md\\` and \\`references/document-quality.md\\`). For\n broad product architecture plans with a user-facing implication, add a\n concrete \"what this looks like in the app\" visual before the abstract\n architecture or mode tables. Keep the document close to the standalone\n Markdown plan the agent would normally output. If an existing plan was\n provided, carry forward the right facts and decisions without referring to\n the previous draft or explaining how this version differs. For non-visual\n plans, skip the top visual surface (Visual Surface Choice below owns the rule)\n and put \\`diagram\\`, \\`data-model\\`,\n \\`api-endpoint\\`, \\`diff\\`, \\`file-tree\\`, \\`code\\`, and \\`annotated-code\\` blocks\n directly next to the relevant prose.\n Wide document layout is renderer-owned and intentionally allowlisted: only\n literal code-review surfaces (\\`diff\\`, \\`annotated-code\\`) and \\`tabs\\` blocks\n with vertical orientation or diff-like children break out wider than prose.\n Keep \\`api-endpoint\\`, \\`openapi-spec\\`, \\`data-model\\`, \\`json-explorer\\`,\n \\`wireframe\\`, question, and \\`custom-html\\` blocks in normal document flow unless\n their own renderer says otherwise.\n4. Surface the returned Plans link or inline MCP App and ask the user to review.\n Always include the actual URL in chat so the next step is a click in CLI or\n other text-only hosts. When the host exposes an embedded browser/preview panel\n and a tool can open arbitrary URLs there, open the returned plan URL\n automatically for convenient review — a convenience and smoke test, never the\n only handoff or the access\n model. Plans should load out of the box for the local agent and local browser\n session; if a signed-in embedded browser cannot read a local plan that an\n anonymous/tool check can read, fix the app/action ownership or access path\n rather than patching one plan by hand. For high-stakes plans (architecture,\n backend, data, multi-file, or risky), also kick off the self-review pass in\n Self-Review Before Handoff while the user reads, instead of blocking the\n handoff on it.\n5. For hosted plans, call \\`get-plan-feedback\\` before editing, after review,\n after any long pause,\n and before the final response. Treat \\`anchorDetails\\`, resolver intent, recent\n review events, and any focused screenshots from browser handoff as the source\n of truth for exactly what changed and exactly what each comment points at.\n6. For hosted plans, apply changes with \\`update-visual-plan\\`, preferring\n targeted \\`contentPatches\\`.\n Treat the top-level \\`content\\` payload as a full replacement, not a merge; do\n not send a partial \\`content\\` object to add a canvas or one block. If a full\n replacement or \\`replace-blocks\\` is unavoidable, call \\`get-visual-plan\\`\n immediately before the write, pass its \\`plan.updatedAt\\` as\n \\`expectedUpdatedAt\\`, and carry forward every existing block and visual\n surface. Never reuse a revision from an earlier read or feedback payload.\n For source-control friendly edits, use granular \\`patch-visual-plan-source\\`\n operations against the MDX files instead of regenerating the plan;\n \\`replace-file\\` is also destructive and requires the same fresh\n \\`expectedUpdatedAt\\` fence.\n7. After every hosted-plan write, call \\`get-visual-plan\\` again and compare the\n persisted text, block IDs/counts, canvas frames, and prototype with the\n intended result. A successful mutation response is not proof that unrelated\n content survived. If the edit addressed agent-targeted feedback, only after\n this verification call \\`resolve-plan-comment\\` for the thread and\n \\`consume-plan-feedback\\` for its comments; do both so addressed feedback is\n neither visibly open nor returned as pending work.\n8. For hosted plans, export with \\`export-visual-plan\\` only when the user wants a\n shareable receipt or repo-check-in artifacts.\n\n## Self-Review Before Handoff\n\nThis adversarial self-review pass is opt-in, not default: run it only for\nhigh-stakes plans — irreversible migrations, security-sensitive work, or when\nthe user explicitly asks for extra rigor — and skip it otherwise. It roughly\ndoubles the cost of plan generation, so the default for small, UI-only,\nsingle-decision, or ordinary plans is to skip it, not to run it. Keep the pass\ncheap and non-blocking when it does run:\n\n- Surface the plan first, review concurrently. Post the link and let the user\n start reading, then run the review in parallel — never make the user wait on it.\n- Review the written plan; do not re-research. Critique the plan text and its\n own blocks. The grounding was already done while drafting, so the review checks\n the output instead of re-exploring the repo.\n- Spawn one skeptical reviewer whose only job is to find what is weak, missing,\n or wrong — not to praise. Point it at: hard-to-reverse decisions made implicitly\n or not at all (wire format, public ids, data-model shape, auth, ownership); steps\n not anchored in real files or symbols; a menu of options where the plan should\n commit to one; obvious missing decisions (\"what happens when X?\", \"why not Y?\");\n and padding or single-step filler.\n- Fix vs. ask. Apply clear-cut fixes yourself with \\`update-visual-plan\\`\n \\`contentPatches\\` — vague non-goals, unanchored claims, an obvious missing\n decision. Route genuine judgment calls back to the user instead: add them to the\n bottom \\`question-form\\` Open Questions block or batch them into the normal\n ask-user-question flow. Do not silently decide them.\n- Do not surprise the user mid-read. On a large plan, apply the patches before\n the editor loads; otherwise note briefly that a self-review is running so the\n plan changing under them is expected. When you next respond, summarize what the\n review changed and what it surfaced for the user to decide.\n\n## Visual Surface Choice\n\nChoose the surface before creating the plan or after reading the source plan. Do\nnot add visual chrome by default:\n\nFor UI/product plans, the top canvas is usually the primary review surface. Put\nthe first meaningful wireframes there, not buried as document-body blocks. Use\nmultiple canvas artboards when states matter, such as the default view, an\noverflow menu or popover, a side panel, loading, or error. Put short annotations\nbeside frames with \\`targetId\\` plus \\`placement\\`; keep implementation details,\ntradeoffs, file maps, data contracts, risks, and verification in the document\nbody below the canvas.\n\nWhen the user asks for a flow, storyboard, journey, wireframe, canvas, or \"what\nthis looks like\", treat that as a canvas-first request. Make one artboard per\nuser-visible state, connect only adjacent transitions, and use short canvas\nannotations for the product notes. Do not substitute a document-body \\`diagram\\`\nblock for the requested storyboard just because HTML diagrams are faster to\nwrite; diagrams belong below the canvas for backend mechanics, architecture, or\ndata-flow explanation.\n\nKeep product wireframes and explanatory/meta diagrams separate. Start with pure\nscreens that look like the app state under discussion, without callout prose or\narchitecture notes embedded inside the UI. Put arrows, labels, contracts, data\nflow, and mode explanations in separate annotations, separate canvas diagrams,\nor the document body.\n\nWhen the plan touches an existing app, inspect the current shell/components\nbefore drawing. The first artboard should look like the real app at the same\ndensity: existing sidebars, toolbar placement, overflow menus, app chrome, and\nframework agent chrome stay in their real places. Model secondary surfaces as\nseparate states, such as a top-right overflow popover, sheet, panel, loading\nstate, or separate AgentSidebar, rather than inventing a permanent inspector or\nfolding framework chrome into the product UI.\n\n- No visual surface for architecture-only, backend-only, data migration,\n copy-only, or otherwise non-visual plans. Do not use the top canvas for\n architecture diagrams, dependency maps, file plans, API contracts, or\n data-flow-only reviews. Use a strong document with local inline diagrams\n only when relationships need a visual explanation, usually one spatial diagram\n per recommendation or decision. Prefer grouped regions, layers, quadrants,\n matrices, or before/after panels over a single-axis chain unless the\n relationship is truly sequential.\n- Canvas only for one static screen, a before/after comparison, a component\n state, a small popover, or a visual direction that does not require clicking.\n Put those wireframes in \\`content.canvas\\` and omit \\`content.prototype\\`.\n- Canvas + prototype for multi-step UI flows, onboarding, wizards,\n review/approval flows, navigation changes, or anything where the reviewer\n needs to operate the behavior. Keep the static wireframes in\n \\`content.canvas\\`, add the aligned functional prototype in\n \\`content.prototype\\`, and rely on the top visual tabs to switch between them.\n- Prototype-first when the user asks to operate the UI or when interaction is\n the main question. Use \\`create-prototype-plan\\`, which still preserves static\n mocks where useful.\n\nFor mixed canvas + prototype plans, reuse the same real labels, app statuses,\nand screen ids across both surfaces. The canvas is the inspectable static reference;\nthe prototype is the interactive version of that same flow, not a separate\ndesign direction.\n\n## Wireframe quality — read \\`references/wireframe.md\\`\n\nUI recap/plan wireframes must meet a strict quality bar — full-width chrome,\npinned bottom bars, real product content, before/after comparability, the right\n\\`surface\\` preset, \\`--wf-\\` tokens instead of hex, and no \\`<html>\\`/\\`<style>\\`/font\ntags. Before authoring ANY wireframe / \\`<Screen>\\` / \\`WireframeBlock\\`, READ\n\\`references/wireframe.md\\` in this skill directory — it is the single source of\ntruth for HTML wireframe quality, shared word for word with \\`/visual-plan\\`\nand \\`/visual-recap\\`. Do not author wireframes from memory.\n\n## Canvas — read \\`references/canvas.md\\`\n\nThe canvas is the single source of truth for static UI mockups: the \\`surface\\`\nlocks each artboard's footprint, mixed surfaces lay out\nin lanes, annotations are plain-text designer notes anchored by\n\\`targetId\\`/\\`placement\\`, and edits are surgical \\`contentPatches\\`. Before\nauthoring or editing ANY canvas, artboard, or annotation, READ\n\\`references/canvas.md\\` in this skill directory — it is the single source of truth\nfor canvas/artboard mechanics. Do not author canvas layouts from memory.\nCanvas artboards use the same HTML wireframe path as document-body\n\\`WireframeBlock\\` screens: author \\`<Screen surface=\"...\" html={...} />\\` with a\nsemantic HTML fragment. Do not author fresh kit-tree children such as\n\\`<FrameScreen>\\`, \\`<Card>\\`, \\`<Row>\\`, or \\`<Btn>\\` inside canvas \\`<Screen>\\` tags;\nthose are legacy compatibility markup for old plans and produce brittle canvas\nlayouts.\n\n## Document quality — read \\`references/document-quality.md\\`\n\nThe document is a serious technical plan, not marketing: outcome-first,\nprose-first, self-contained, built from the right native blocks, with open\nquestions in a single bottom \\`question-form\\` and a pre-handoff visual check.\nBefore authoring the plan document, READ \\`references/document-quality.md\\` in this\nskill directory — it is the single source of truth for the document quality bar.\nDo not write the document from memory.\n\n## Good vs. bad exemplar — read \\`references/exemplar.md\\`\n\nFor a worked example of the bar — a great UI-first plan and \\`/visual-plan\\`, plus\nthe anti-patterns to avoid — READ \\`references/exemplar.md\\` in this skill\ndirectory before authoring a plan.\n\n## Tool Guidance\n\n- \\`create-visual-plan\\`: start one structured visual plan per agent task/run, or\n import an existing text plan by passing \\`planText\\`; \\`content\\` may include no\n visual surface, canvas only, or canvas + prototype.\n- \\`create-ui-plan\\`: start a UI-first plan when the work is primarily product UI.\n- \\`create-prototype-plan\\`: start a prototype-first plan with a functional top\n review surface.\n- \\`create-plan-design\\`: start a full-fidelity branded Design-tab plan with an\n optional matching Prototype tab.\n- \\`convert-visual-plan-to-prototype\\`: convert an existing HTML wireframe canvas\n into a prototype plan.\n- \\`create-visual-questions\\`: use only when the user explicitly asks for a visual\n intake questionnaire, not as \\`/visual-plan\\` preflight.\n- \\`update-visual-plan\\`: revise content, status, or comments with targeted\n \\`contentPatches\\` (see Core Workflow steps 6-7). \\`replace-blocks\\` and full\n \\`content\\` replacement require \\`expectedUpdatedAt\\` from a fresh\n \\`get-visual-plan\\` call.\n- \\`read-visual-plan-source\\`: read the normalized plan as \\`plan.mdx\\`,\n optional \\`canvas.mdx\\`, optional \\`.plan-state.json\\`, and JSON.\n- \\`patch-visual-plan-source\\`: apply granular MDX AST patches by stable block,\n artboard, annotation, component, or wireframe-node id. Prefer those targeted\n operations; \\`replace-file\\` requires \\`expectedUpdatedAt\\` from a fresh\n \\`get-visual-plan\\` call.\n- \\`import-visual-plan-source\\`: create or replace a plan from an MDX folder.\n- \\`get-visual-plan\\`: read the current structured plan, exported HTML,\n annotations, and \\`plan.updatedAt\\`; it also returns the MDX folder for source\n workflows. Re-read immediately before a destructive write for its concurrency\n fence and again after every write to verify persisted state.\n- \\`get-plan-feedback\\`: read unconsumed human feedback. Use it frequently; it\n returns grouped threads, exact anchor details, expected resolver, and recent\n review-event payloads so agents can act only on the comments meant for them.\n- \\`get-plan-blocks\\`: resolve block tags before authoring — do not memorize tags;\n call this first to get the authoritative tag names, required fields, and prop\n shapes from the live block registry.\n- \\`export-visual-plan\\`: export HTML, Markdown fallback, structured JSON, and MDX\n files for repo check-in.\n\nWhen the user critiques a plan's look or structure, fix the renderer or this\nskill — never hand-edit one stored plan. Turn feedback into better guidance.\n\n## Local-Files Privacy Mode — read \\`references/local-files.md\\`\n\nWhen the user wants no hosted Plan database writes — no DB writes, no Plan MCP\npublish, fully local/offline/private planning, repo-owned source-controlled\nartifacts, or \\`AGENT_NATIVE_PLANS_MODE=local-files\\` — do not call any hosted Plan\ntool except the schema-only \\`get-plan-blocks\\` catalog lookup. Author a local MDX\nfolder and\npreview it with \\`plan local check\\` / \\`plan local serve\\` / \\`plan local verify\\`.\nBefore using local-files mode, READ \\`references/local-files.md\\` in this skill\ndirectory — it is the single source of truth for the full contract (catalog\nlookup, MDX folder layout, the local bridge commands, and the hosted tools you\nmust not call). Carry forward only the code-research and plan-composition\nguidance from Core Workflow; everything hosted is replaced by the local bridge.\n\n## Interpreting comment anchors\n\nThis section applies to hosted plans with \\`get-plan-feedback\\` /\n\\`update-visual-plan\\`. In local-files mode, do not call hosted feedback or update\ntools; interpret file/chat feedback directly, edit the MDX files, rerun the\nlocal bridge check/serve/verify command, and report the new local URL.\n\n\\`get-plan-feedback\\` returns rich anchors — read them before acting on any comment.\n\n- Coordinate frames.* \\`targetX\\`/\\`targetY\\` are percentages within the\n element named by \\`targetSelector\\`/\\`targetKind\\`. Bare \\`x\\`/\\`y\\` are percentages\n of the whole plan document. \\`canvasX\\`/\\`canvasY\\` are raw board-world pixels on\n the design canvas (board size given when available).\n- Wireframe pins. Anchors on wireframes include \\`targetNodeId\\` and\n \\`targetNodePath\\` (e.g. \\`card > list > listItem \"Acme Inc\"\\`) identifying the\n exact kit node. Use \\`targetNodeId\\` directly with wireframe node patch ops;\n use \\`data-design-id\\` values from design artboards with\n \\`update-design-element-style\\`. Prefer the node id/path over raw coordinates;\n fall back to coordinates plus the focused screenshot (red ring marks the exact\n point) only when no node id is present.\n- Text quotes. Resolve \\`textQuote\\` against current prose using\n \\`contextBefore\\`/\\`contextAfter\\` for disambiguation. If \\`ambiguous: true\\`, ask\n the user — do not guess which occurrence is meant.\n- Detached comments. \\`get-plan-feedback\\` flags threads whose quoted text no\n longer exists as \\`detached\\` (in \\`detachedThreads\\`). Reconcile these against\n rewritten content — never silently drop them.\n- Routing. \\`resolutionTarget\\` is the only routing signal: act on \\`agent\\`,\n treat \\`human\\` as context only. \\`@mentions\\` are people to notify, never a\n routing signal.\n- Two-axis state. Mark every ingested comment as consumed\n (\\`consumedCommentIds\\` on \\`update-visual-plan\\`). Set \\`status=resolved\\` only on\n agent-targeted comments you actually addressed; leave human-targeted comments\n open. When an edit addresses feedback, first re-read the persisted plan and\n verify the requested change. Only then call \\`resolve-plan-comment\\` for the\n addressed thread and \\`consume-plan-feedback\\` for its comments; never mark\n addressed feedback along only one axis.\n\n## Visibility & Sharing\n\nUse \\`set-resource-visibility\\` to change who can see a plan (e.g. public, login,\nor org-scoped). Use \\`share-resource\\` to grant specific users or roles access\nby email or role. Gate visibility before sharing any plan that covers\nunreleased or private work — default to the narrowest scope that meets the\nreview need.\n\n## Setup & Authentication\n\nThere are two ways into Plans.\n\nCoding agent (CLI). Install once with the Agent-Native CLI. The command\ninstalls the Plans skills, registers the hosted Plans MCP connector, and runs\nauth/setup for the selected local client(s) in the same step (a one-time browser\nsign-in at setup — this is intended), so the first tool call in that client does\nnot hit an OAuth wall:\n\n\\`\\`\\`bash\nnpx @agent-native/core@latest skills add visual-plans\n\\`\\`\\`\n\nAfter that, \\`/visual-plan\\`, \\`/visual-recap\\`, and \\`/visualize-repo\\` are the\ninstalled slash commands. If you only need one command, use\n\\`skills add visual-plan\\`, \\`skills add visual-recap\\`, or\n\\`skills add visualize-repo\\` instead. The other planning modes\n(\\`create-ui-plan\\`, \\`create-prototype-plan\\`, \\`create-plan-design\\`,\n\\`create-visual-questions\\`) are MCP tools reachable from \\`/visual-plan\\`, not\nseparate slash commands. Pass \\`--no-connect\\` to register the connector without\nauthenticating, then run\n\\`npx @agent-native/core@latest connect https://plan.agent-native.com --client all\\`\nwhenever you are ready, or choose a narrower \\`--client\\`. Auth and MCP tool\nloading are per client config/session.\n\nBrowser (people you share with). Open the Plans editor and create & edit\nwith no sign-up — you work as a guest. Sign in only when you want to save or\nshare; signing in claims the plans you made as a guest into your account.\n\nSharing and commenting require an account: public/shared plans are viewable by\nanyone with the link, but commenting on them needs an agent-native account.\n\nFor fully offline, no-account use, run the Plans app locally and sync plans to\nyour repo as MDX. This local mode is a separate advanced path, not the default\nhosted flow.\n\nFor repo-wide visual docs, run\n\\`npx @agent-native/core@latest visualize-repo --open\\` to create/update\n\\`agent-native.json\\`, seed \\`.agent-native/visual-docs/repo-overview\\`, and open\nthe local bridge.\n\nIf a Plans tool returns \\`needs auth\\`, \\`Unauthorized\\`, or \\`Session terminated\\`, do\nnot keep retrying it — stop and give the user the per-client reconnect step from\n\\`references/connection.md\\`, then continue once the connector is available.\n\nHosted default: connect \\`https://plan.agent-native.com/mcp\\`. Do\nnot put shared secrets in skill files.\n`;\n"]}
1	+ {"version":3,"file":"visual-plan-skill.js","sourceRoot":"","sources":["../../../src/cli/skills-content/visual-plan-skill.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4epC,CAAC","sourcesContent":["export const VISUAL_PLANS_SKILL_MD = `---\nname: visual-plan\ndescription: >-\n Turn ordinary text plans into rich interactive visual plans with diagrams,\n file maps, annotated code, open questions, and UI/prototype review when\n useful.\nmetadata:\n visibility: exported\n---\n\n# Agent-Native Plans\n\nAgent-Native Plans is structured visual planning mode for coding agents. Build\nthe plan you would normally write in Markdown, but as a scannable document with\neditable blocks mixed in: inline diagrams, code snippets,\nopen questions, and an optional top visual review area (wireframe canvas, live\nprototype, or both in tabs). Architecture and backend plans stay document-only;\nUI and product plans start with the top canvas/prototype (the Visual Surface\nChoice section owns that rule).\n\n\\`/visual-plan\\` is the packaged command and main entry point. Choose the review\nmode from the task: UI-first when the work is primarily product UI and review\nshould start with screens, prototype-first when review should start with a\nfunctional live prototype, design-first when review needs full-fidelity branded\nscreens, or visual-intake when the user explicitly wants a questionnaire before\nplanning. When a Codex, Claude Code, Markdown, or pasted plan already exists,\n\\`/visual-plan\\` uses that source plan as the starting point and builds the review\nsurface from it instead of starting over.\n\n## When To Use\n\nCreate or adapt a visual plan whenever the plan would be better as a reviewable\nartifact than a chat paragraph. This includes modest work such as a single UI\nsurface with states, a small workflow, a before/after product change, or a\ncomponent/API/data-shape decision that needs alignment, plus larger multi-file,\nambiguous, long-running, risky, or UI-heavy work. Use it when architecture /\ndata flow / UI direction / options / open questions would benefit from inline\ndiagrams or structured blocks, when the user needs to react to a direction\nbefore you implement, or when an existing text plan needs a richer review\nsurface.\n\n## Plan Discipline\n\n- Gate thoughtfully. A visual plan is a richer review surface, not only a\n tool for giant projects. Use it when the user needs to see, compare, comment\n on, or approve a direction before code, even for a modest UI/state/workflow\n change. Skip it for truly trivial, unambiguous work — typos, one-line fixes, a\n single well-specified function, anything whose diff you could describe in one\n sentence — and just make the change. Never pad a plan with filler and never\n ship a single-step plan.\n- Research before you draft. Read the real files, actions, schema, and\n patterns first; name actual files, symbols, and data shapes instead of\n inventing them. Check existing \\`actions/\\` before proposing endpoints and prefer\n named client helpers over raw fetch. Delegate wide exploration to a sub-agent.\n Lead with reuse: for each step, name what it reuses — existing actions, schema,\n components, helpers — before what it adds, so the plan explains the genuinely new\n delta instead of redescribing what already exists.\n- Decide the hard-to-reverse bets first. For non-trivial backend, data, or API\n work, sketch where the feature is headed, then call out the decisions that are\n expensive to undo once data or callers depend on them — wire format, public ids,\n data-model shape, auth and ownership boundaries — and get those right in the plan\n even if most of the feature ships later. Then scope to the smallest first cut that\n proves the approach without foreclosing it, stating both what is in and what is\n explicitly deferred.\n- Keep examples at the right altitude. When the user's idea is a broad\n framework, product, or operating-model change, do not collapse it into the\n first concrete example, provider, or sync path they mention. Separate the core\n abstraction from motivating examples and app/provider adapters. Use examples\n to make the plan legible, but label them as examples unless they are the whole\n requested scope.\n- Publish standalone plans. If the user pasted, referenced, or already has a\n Codex / Claude Code / Markdown plan, treat it as source material, but rewrite\n the published plan as a clean standalone proposal. Preserve the source plan's\n useful intent and codebase facts, label inferred visuals as inferred, and avoid\n revision language such as \"preserve the prior plan\", \"do not drop the old\n idea\", \"unlike the previous version\", or \"this revision changes...\". A reader\n who never saw the chat or earlier drafts should understand the plan.\n- Make the first read concrete. If the plan is meant to be shared with\n someone outside the chat, or if the concept is abstract, lead near the top with\n one concrete product example before mode tables, architecture, or roadmaps. For\n UI-capable concepts, that usually means a top-canvas app state that shows the\n real user workflow in product terms. Do not rely on phrases that only make\n sense in conversation, and do not frame the plan as \"not the old idea\"; state\n the positive model directly.\n- Planning is read-only. Make no source edits while building or reviewing the\n plan. Start editing only after the user approves the direction.\n- Clarify vs. assume. Do not ask how to build it — explore and present the\n approach and options in the plan. Ask a clarifying question only when an\n ambiguity would change the design and you cannot resolve it from the code; use\n the host agent's normal ask-user-question flow and batch 2-4 high-leverage\n questions before finalizing. Do not call \\`create-visual-questions\\` for\n ordinary clarification or preflight; reserve it for the visual-intake mode when\n the user explicitly asks for a visual intake questionnaire. Otherwise state the\n assumption explicitly and proceed, and keep anything unresolved in the plan's\n single bottom \\`question-form\\` Open Questions block. For complex plans, do a\n final open-question pass before handoff: if a decision would affect\n architecture, scope, UX, data shape, or rollout, either decide it in the plan\n with rationale or put it in that bottom form with a recommended default.\n- The plan is the approval gate. After surfacing it, ask the user to review\n and approve before you write code, and name which files/areas the work touches.\n Presenting the plan and requesting sign-off is the approval step — do not ask a\n separate \"does this look good?\" question.\n- The document is the source of truth, not the chat. When scope shifts,\n update the plan with \\`update-visual-plan\\` rather than only changing course in\n chat, and make the updated document stand alone. Do not describe the update as\n a correction to an earlier draft inside the plan itself. Re-read the approved\n plan before major steps.\n\n## Create A Structured Agent-Native Plan — Never Inline\n\nThe deliverable is ALWAYS a structured Agent-Native Plan, not a chat-only plan.\nThe hosted Plan MCP connector (\\`plan\\` server, or legacy \\`agent-native-plans\\`) is\nthe default collaboration and commenting surface; it is not a reason to reject\nthe planning pattern as an external dependency or rented layer. Plans are\nportable source artifacts (\\`plan.mdx\\`, optional \\`canvas.mdx\\` /\n\\`prototype.mdx\\`, JSON, and HTML export), and ownership-sensitive workflows can\nuse local-files mode or a self-hosted/custom Plan app URL without abandoning the\nskill's review discipline. Do not advise the user to skip \\`/visual-plan\\` because\nthe default surface is hosted; choose the right Plan mode for the user's\nownership, privacy, sharing, and branding needs.\n\nBy default, create the plan via the Plan MCP connector and NEVER hand it over as\ninline chat content — no Markdown prose, ASCII sketch, table, or fenced\nwireframe. If the \\`plan\\` (or legacy \\`agent-native-plans\\`) tools are not visible,\ndiscover them through the host's \\`tool_search\\` first; if they are still missing,\nSTOP and give the user the client-specific reconnect step rather than improvising\nan inline plan. Before publishing, or whenever a connector or auth error appears,\nREAD \\`references/connection.md\\` in this skill directory — it is the single source\nof truth for the never-inline rule, connector discovery, and the per-client\nreconnect steps. Local-files privacy mode (after Tool Guidance) is the exception.\n\n## Core Workflow\n\nThis section describes the default hosted Plan MCP workflow. If\n\\`AGENT_NATIVE_PLANS_MODE=local-files\\` is set, or the user asks for fully local\nfiles/no hosted Plan writes, use Local-Files Privacy Mode instead; carry\nforward only the code-research and plan-composition guidance here.\n\n1. Follow the host agent's normal planning flow: inspect the codebase, delegate\n wide exploration when useful, gather the info needed, and ask native\n clarifying questions as needed before generating the plan. If a source plan\n already exists, gather its exact text from the user's paste, a referenced\n file, or recent visible agent context; do not invent source text.\n2. Call \\`get-plan-blocks\\` for the authoritative block catalog — do not author\n from memorized tags. Then call the mode-matched create tool:\n \\`create-visual-plan\\` for document-first plans (architecture, backend, data,\n refactor, API), \\`create-ui-plan\\` for UI-first plans, \\`create-prototype-plan\\`\n for prototype-first plans, \\`create-plan-design\\` for design-first plans,\n \\`create-visual-questions\\` only when the user explicitly asks for a visual\n intake questionnaire. When a source plan already exists,\n pass it as \\`planText\\` and preserve the original plan's useful intent while\n producing a standalone plan document, not a revision memo.\n3. For UI/product plans, compose the top canvas first with the primary\n wireframes and annotated states, then write the document with native blocks\n (see \\`references/canvas.md\\` and \\`references/document-quality.md\\`). For\n broad product architecture plans with a user-facing implication, add a\n concrete \"what this looks like in the app\" visual before the abstract\n architecture or mode tables. Keep the document close to the standalone\n Markdown plan the agent would normally output. If an existing plan was\n provided, carry forward the right facts and decisions without referring to\n the previous draft or explaining how this version differs. For non-visual\n plans, skip the top visual surface (Visual Surface Choice below owns the rule)\n and put \\`diagram\\`, \\`data-model\\`,\n \\`api-endpoint\\`, \\`diff\\`, \\`file-tree\\`, \\`code\\`, and \\`annotated-code\\` blocks\n directly next to the relevant prose.\n Wide document layout is renderer-owned and intentionally allowlisted: only\n literal code-review surfaces (\\`diff\\`, \\`annotated-code\\`) and \\`tabs\\` blocks\n with vertical orientation or diff-like children break out wider than prose.\n Keep \\`api-endpoint\\`, \\`openapi-spec\\`, \\`data-model\\`, \\`json-explorer\\`,\n \\`wireframe\\`, question, and \\`custom-html\\` blocks in normal document flow unless\n their own renderer says otherwise.\n4. Surface the returned Plans link or inline MCP App and ask the user to review.\n Always include the actual URL in chat so the next step is a click in CLI or\n other text-only hosts. When the host exposes an embedded browser/preview panel\n and a tool can open arbitrary URLs there, open the returned plan URL\n automatically for convenient review — a convenience and smoke test, never the\n only handoff or the access\n model. Plans should load out of the box for the local agent and local browser\n session; if a signed-in embedded browser cannot read a local plan that an\n anonymous/tool check can read, fix the app/action ownership or access path\n rather than patching one plan by hand. For high-stakes plans (architecture,\n backend, data, multi-file, or risky), also kick off the self-review pass in\n Self-Review Before Handoff while the user reads, instead of blocking the\n handoff on it.\n5. For hosted plans, call \\`get-plan-feedback\\` before editing, after review,\n after any long pause,\n and before the final response. Treat \\`anchorDetails\\`, resolver intent, recent\n review events, and any focused screenshots from browser handoff as the source\n of truth for exactly what changed and exactly what each comment points at.\n6. For hosted plans, apply changes with \\`update-visual-plan\\`, preferring\n targeted \\`contentPatches\\`.\n Treat the top-level \\`content\\` payload as a full replacement, not a merge; do\n not send a partial \\`content\\` object to add a canvas or one block. If a full\n replacement or \\`replace-blocks\\` is unavoidable, call \\`get-visual-plan\\`\n immediately before the write, pass its \\`plan.updatedAt\\` as\n \\`expectedUpdatedAt\\`, and carry forward every existing block and visual\n surface. Never reuse a revision from an earlier read or feedback payload.\n For source-control friendly edits, use granular \\`patch-visual-plan-source\\`\n operations against the MDX files instead of regenerating the plan;\n \\`replace-file\\` is also destructive and requires the same fresh\n \\`expectedUpdatedAt\\` fence.\n7. After every hosted-plan write, call \\`get-visual-plan\\` again and compare the\n persisted text, block IDs/counts, canvas frames, and prototype with the\n intended result. A successful mutation response is not proof that unrelated\n content survived. If the edit addressed agent-targeted feedback, only after\n this verification call \\`resolve-plan-comment\\` for the thread and\n \\`consume-plan-feedback\\` for its comments; do both so addressed feedback is\n neither visibly open nor returned as pending work.\n8. For hosted plans, export with \\`export-visual-plan\\` only when the user wants a\n shareable receipt or repo-check-in artifacts.\n\n## Self-Review Before Handoff\n\nThis adversarial self-review pass is opt-in, not default: run it only for\nhigh-stakes plans — irreversible migrations, security-sensitive work, or when\nthe user explicitly asks for extra rigor — and skip it otherwise. It roughly\ndoubles the cost of plan generation, so the default for small, UI-only,\nsingle-decision, or ordinary plans is to skip it, not to run it. Keep the pass\ncheap and non-blocking when it does run:\n\n- Surface the plan first, review concurrently. Post the link and let the user\n start reading, then run the review in parallel — never make the user wait on it.\n- Review the written plan; do not re-research. Critique the plan text and its\n own blocks. The grounding was already done while drafting, so the review checks\n the output instead of re-exploring the repo.\n- Spawn one skeptical reviewer whose only job is to find what is weak, missing,\n or wrong — not to praise. Point it at: hard-to-reverse decisions made implicitly\n or not at all (wire format, public ids, data-model shape, auth, ownership); steps\n not anchored in real files or symbols; a menu of options where the plan should\n commit to one; obvious missing decisions (\"what happens when X?\", \"why not Y?\");\n and padding or single-step filler.\n- Fix vs. ask. Apply clear-cut fixes yourself with \\`update-visual-plan\\`\n \\`contentPatches\\` — vague non-goals, unanchored claims, an obvious missing\n decision. Route genuine judgment calls back to the user instead: add them to the\n bottom \\`question-form\\` Open Questions block or batch them into the normal\n ask-user-question flow. Do not silently decide them.\n- Do not surprise the user mid-read. On a large plan, apply the patches before\n the editor loads; otherwise note briefly that a self-review is running so the\n plan changing under them is expected. When you next respond, summarize what the\n review changed and what it surfaced for the user to decide.\n\n## Visual Surface Choice\n\nChoose the surface before creating the plan or after reading the source plan. Do\nnot add visual chrome by default:\n\nFor UI/product plans, the top canvas is usually the primary review surface. Put\nthe first meaningful wireframes there, not buried as document-body blocks. Use\nmultiple canvas artboards when states matter, such as the default view, an\noverflow menu or popover, a side panel, loading, or error. Put short annotations\nbeside frames with \\`targetId\\` plus \\`placement\\`; keep implementation details,\ntradeoffs, file maps, data contracts, risks, and verification in the document\nbody below the canvas.\n\nWhen the user asks for a flow, storyboard, journey, wireframe, canvas, or \"what\nthis looks like\", treat that as a canvas-first request. Make one artboard per\nuser-visible state, connect only adjacent transitions, and use short canvas\nannotations for the product notes. Do not substitute a document-body \\`diagram\\`\nblock for the requested storyboard just because HTML diagrams are faster to\nwrite; diagrams belong below the canvas for backend mechanics, architecture, or\ndata-flow explanation.\n\nKeep product wireframes and explanatory/meta diagrams separate. Start with pure\nscreens that look like the app state under discussion, without callout prose or\narchitecture notes embedded inside the UI. Put arrows, labels, contracts, data\nflow, and mode explanations in separate annotations, separate canvas diagrams,\nor the document body.\n\nWhen the plan touches an existing app, inspect the current shell/components\nbefore drawing. The first artboard should look like the real app at the same\ndensity: existing sidebars, toolbar placement, overflow menus, app chrome, and\nframework agent chrome stay in their real places. Model secondary surfaces as\nseparate states, such as a top-right overflow popover, sheet, panel, loading\nstate, or separate AgentSidebar, rather than inventing a permanent inspector or\nfolding framework chrome into the product UI.\n\n- No visual surface for architecture-only, backend-only, data migration,\n copy-only, or otherwise non-visual plans. Do not use the top canvas for\n architecture diagrams, dependency maps, file plans, API contracts, or\n data-flow-only reviews. Use a strong document with local inline diagrams\n only when relationships need a visual explanation, usually one spatial diagram\n per recommendation or decision. Prefer grouped regions, layers, quadrants,\n matrices, or before/after panels over a single-axis chain unless the\n relationship is truly sequential.\n- Canvas only for one static screen, a before/after comparison, a component\n state, a small popover, or a visual direction that does not require clicking.\n Put those wireframes in \\`content.canvas\\` and omit \\`content.prototype\\`.\n- Canvas + prototype for multi-step UI flows, onboarding, wizards,\n review/approval flows, navigation changes, or anything where the reviewer\n needs to operate the behavior. Keep the static wireframes in\n \\`content.canvas\\`, add the aligned functional prototype in\n \\`content.prototype\\`, and rely on the top visual tabs to switch between them.\n When both surfaces are present, open the Wireframes tab by default; the\n prototype remains available as the interactive follow-up view.\n- Prototype-first when the user asks to operate the UI or when interaction is\n the main question. Use \\`create-prototype-plan\\`, which still preserves static\n mocks where useful.\n\nFor mixed canvas + prototype plans, reuse the same real labels, app statuses,\nand screen ids across both surfaces. The canvas is the inspectable static reference;\nthe prototype is the interactive version of that same flow, not a separate\ndesign direction.\n\n## Wireframe quality — read \\`references/wireframe.md\\`\n\nUI recap/plan wireframes must meet a strict quality bar — full-width chrome,\npinned bottom bars, real product content, before/after comparability, the right\n\\`surface\\` preset, \\`--wf-\\` tokens instead of hex, and no \\`<html>\\`/\\`<style>\\`/font\ntags. Before authoring ANY wireframe / \\`<Screen>\\` / \\`WireframeBlock\\`, READ\n\\`references/wireframe.md\\` in this skill directory — it is the single source of\ntruth for HTML wireframe quality, shared word for word with \\`/visual-plan\\`\nand \\`/visual-recap\\`. Do not author wireframes from memory.\n\n## Canvas — read \\`references/canvas.md\\`\n\nThe canvas is the single source of truth for static UI mockups: the \\`surface\\`\nlocks each artboard's footprint, mixed surfaces lay out\nin lanes, annotations are plain-text designer notes anchored by\n\\`targetId\\`/\\`placement\\`, and edits are surgical \\`contentPatches\\`. Before\nauthoring or editing ANY canvas, artboard, or annotation, READ\n\\`references/canvas.md\\` in this skill directory — it is the single source of truth\nfor canvas/artboard mechanics. Do not author canvas layouts from memory.\nCanvas artboards use the same HTML wireframe path as document-body\n\\`WireframeBlock\\` screens: author \\`<Screen surface=\"...\" html={...} />\\` with a\nsemantic HTML fragment. Do not author fresh kit-tree children such as\n\\`<FrameScreen>\\`, \\`<Card>\\`, \\`<Row>\\`, or \\`<Btn>\\` inside canvas \\`<Screen>\\` tags;\nthose are legacy compatibility markup for old plans and produce brittle canvas\nlayouts.\n\n## Document quality — read \\`references/document-quality.md\\`\n\nThe document is a serious technical plan, not marketing: outcome-first,\nprose-first, self-contained, built from the right native blocks, with open\nquestions in a single bottom \\`question-form\\` and a pre-handoff visual check.\nBefore authoring the plan document, READ \\`references/document-quality.md\\` in this\nskill directory — it is the single source of truth for the document quality bar.\nDo not write the document from memory.\n\n## Good vs. bad exemplar — read \\`references/exemplar.md\\`\n\nFor a worked example of the bar — a great UI-first plan and \\`/visual-plan\\`, plus\nthe anti-patterns to avoid — READ \\`references/exemplar.md\\` in this skill\ndirectory before authoring a plan.\n\n## Tool Guidance\n\n- \\`create-visual-plan\\`: start one structured visual plan per agent task/run, or\n import an existing text plan by passing \\`planText\\`; \\`content\\` may include no\n visual surface, canvas only, or canvas + prototype.\n- \\`create-ui-plan\\`: start a UI-first plan when the work is primarily product UI.\n- \\`create-prototype-plan\\`: start a prototype-first plan with a functional top\n review surface.\n- \\`create-plan-design\\`: start a full-fidelity branded Design-tab plan with an\n optional matching Prototype tab.\n- \\`convert-visual-plan-to-prototype\\`: convert an existing HTML wireframe canvas\n into a prototype plan.\n- \\`create-visual-questions\\`: use only when the user explicitly asks for a visual\n intake questionnaire, not as \\`/visual-plan\\` preflight.\n- \\`update-visual-plan\\`: revise content, status, or comments with targeted\n \\`contentPatches\\` (see Core Workflow steps 6-7). \\`replace-blocks\\` and full\n \\`content\\` replacement require \\`expectedUpdatedAt\\` from a fresh\n \\`get-visual-plan\\` call.\n- \\`read-visual-plan-source\\`: read the normalized plan as \\`plan.mdx\\`,\n optional \\`canvas.mdx\\`, optional \\`.plan-state.json\\`, and JSON.\n- \\`patch-visual-plan-source\\`: apply granular MDX AST patches by stable block,\n artboard, annotation, component, or wireframe-node id. Prefer those targeted\n operations; \\`replace-file\\` requires \\`expectedUpdatedAt\\` from a fresh\n \\`get-visual-plan\\` call.\n- \\`import-visual-plan-source\\`: create or replace a plan from an MDX folder.\n- \\`get-visual-plan\\`: read the current structured plan, exported HTML,\n annotations, and \\`plan.updatedAt\\`; it also returns the MDX folder for source\n workflows. Re-read immediately before a destructive write for its concurrency\n fence and again after every write to verify persisted state.\n- \\`get-plan-feedback\\`: read unconsumed human feedback. Use it frequently; it\n returns grouped threads, exact anchor details, expected resolver, and recent\n review-event payloads so agents can act only on the comments meant for them.\n- \\`get-plan-blocks\\`: resolve block tags before authoring — do not memorize tags;\n call this first to get the authoritative tag names, required fields, and prop\n shapes from the live block registry.\n- \\`export-visual-plan\\`: export HTML, Markdown fallback, structured JSON, and MDX\n files for repo check-in.\n\nWhen the user critiques a plan's look or structure, fix the renderer or this\nskill — never hand-edit one stored plan. Turn feedback into better guidance.\n\n## Local-Files Privacy Mode — read \\`references/local-files.md\\`\n\nWhen the user wants no hosted Plan database writes — no DB writes, no Plan MCP\npublish, fully local/offline/private planning, repo-owned source-controlled\nartifacts, or \\`AGENT_NATIVE_PLANS_MODE=local-files\\` — do not call any hosted Plan\ntool except the schema-only \\`get-plan-blocks\\` catalog lookup. Author a local MDX\nfolder and\npreview it with \\`plan local check\\` / \\`plan local serve\\` / \\`plan local verify\\`.\nBefore using local-files mode, READ \\`references/local-files.md\\` in this skill\ndirectory — it is the single source of truth for the full contract (catalog\nlookup, MDX folder layout, the local bridge commands, and the hosted tools you\nmust not call). Carry forward only the code-research and plan-composition\nguidance from Core Workflow; everything hosted is replaced by the local bridge.\n\n## Interpreting comment anchors\n\nThis section applies to hosted plans with \\`get-plan-feedback\\` /\n\\`update-visual-plan\\`. In local-files mode, do not call hosted feedback or update\ntools; interpret file/chat feedback directly, edit the MDX files, rerun the\nlocal bridge check/serve/verify command, and report the new local URL.\n\n\\`get-plan-feedback\\` returns rich anchors — read them before acting on any comment.\n\n- Coordinate frames.* \\`targetX\\`/\\`targetY\\` are percentages within the\n element named by \\`targetSelector\\`/\\`targetKind\\`. Bare \\`x\\`/\\`y\\` are percentages\n of the whole plan document. \\`canvasX\\`/\\`canvasY\\` are raw board-world pixels on\n the design canvas (board size given when available).\n- Wireframe pins. Anchors on wireframes include \\`targetNodeId\\` and\n \\`targetNodePath\\` (e.g. \\`card > list > listItem \"Acme Inc\"\\`) identifying the\n exact kit node. Use \\`targetNodeId\\` directly with wireframe node patch ops;\n use \\`data-design-id\\` values from design artboards with\n \\`update-design-element-style\\`. Prefer the node id/path over raw coordinates;\n fall back to coordinates plus the focused screenshot (red ring marks the exact\n point) only when no node id is present.\n- Text quotes. Resolve \\`textQuote\\` against current prose using\n \\`contextBefore\\`/\\`contextAfter\\` for disambiguation. If \\`ambiguous: true\\`, ask\n the user — do not guess which occurrence is meant.\n- Detached comments. \\`get-plan-feedback\\` flags threads whose quoted text no\n longer exists as \\`detached\\` (in \\`detachedThreads\\`). Reconcile these against\n rewritten content — never silently drop them.\n- Routing. \\`resolutionTarget\\` is the only routing signal: act on \\`agent\\`,\n treat \\`human\\` as context only. \\`@mentions\\` are people to notify, never a\n routing signal.\n- Two-axis state. Mark every ingested comment as consumed\n (\\`consumedCommentIds\\` on \\`update-visual-plan\\`). Set \\`status=resolved\\` only on\n agent-targeted comments you actually addressed; leave human-targeted comments\n open. When an edit addresses feedback, first re-read the persisted plan and\n verify the requested change. Only then call \\`resolve-plan-comment\\` for the\n addressed thread and \\`consume-plan-feedback\\` for its comments; never mark\n addressed feedback along only one axis.\n\n## Visibility & Sharing\n\nUse \\`set-resource-visibility\\` to change who can see a plan (e.g. public, login,\nor org-scoped). Use \\`share-resource\\` to grant specific users or roles access\nby email or role. Gate visibility before sharing any plan that covers\nunreleased or private work — default to the narrowest scope that meets the\nreview need.\n\n## Setup & Authentication\n\nThere are two ways into Plans.\n\nCoding agent (CLI). Install once with the Agent-Native CLI. The command\ninstalls the Plans skills, registers the hosted Plans MCP connector, and runs\nauth/setup for the selected local client(s) in the same step (a one-time browser\nsign-in at setup — this is intended), so the first tool call in that client does\nnot hit an OAuth wall:\n\n\\`\\`\\`bash\nnpx @agent-native/core@latest skills add visual-plans\n\\`\\`\\`\n\nAfter that, \\`/visual-plan\\`, \\`/visual-recap\\`, and \\`/visualize-repo\\` are the\ninstalled slash commands. If you only need one command, use\n\\`skills add visual-plan\\`, \\`skills add visual-recap\\`, or\n\\`skills add visualize-repo\\` instead. The other planning modes\n(\\`create-ui-plan\\`, \\`create-prototype-plan\\`, \\`create-plan-design\\`,\n\\`create-visual-questions\\`) are MCP tools reachable from \\`/visual-plan\\`, not\nseparate slash commands. Pass \\`--no-connect\\` to register the connector without\nauthenticating, then run\n\\`npx @agent-native/core@latest connect https://plan.agent-native.com --client all\\`\nwhenever you are ready, or choose a narrower \\`--client\\`. Auth and MCP tool\nloading are per client config/session.\n\nBrowser (people you share with). Open the Plans editor and create & edit\nwith no sign-up — you work as a guest. Sign in only when you want to save or\nshare; signing in claims the plans you made as a guest into your account.\n\nSharing and commenting require an account: public/shared plans are viewable by\nanyone with the link, but commenting on them needs an agent-native account.\n\nFor fully offline, no-account use, run the Plans app locally and sync plans to\nyour repo as MDX. This local mode is a separate advanced path, not the default\nhosted flow.\n\nFor repo-wide visual docs, run\n\\`npx @agent-native/core@latest visualize-repo --open\\` to create/update\n\\`agent-native.json\\`, seed \\`.agent-native/visual-docs/repo-overview\\`, and open\nthe local bridge.\n\nIf a Plans tool returns \\`needs auth\\`, \\`Unauthorized\\`, or \\`Session terminated\\`, do\nnot keep retrying it — stop and give the user the per-client reconnect step from\n\\`references/connection.md\\`, then continue once the connector is available.\n\nHosted default: connect \\`https://plan.agent-native.com/mcp\\`. Do\nnot put shared secrets in skill files.\n`;\n"]}

package/dist/client/context-xray/ContextMeter.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"ContextMeter.d.ts","sourceRoot":"","sources":["../../../src/client/context-xray/ContextMeter.tsx"],"names":[],"mappings":"~~AAEA~~,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,8BAA8B,CAAC;~~AA4DtC~~,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,QAAQ,EAAE,gBAAgB,EAC1B,OAAc,GACf,EAAE;IACD,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,~~sCAkIA~~"}
1	+ {"version":3,"file":"ContextMeter.d.ts","sourceRoot":"","sources":["../../../src/client/context-xray/ContextMeter.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,8BAA8B,CAAC;AActC,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,QAAQ,EAAE,gBAAgB,EAC1B,OAAc,GACf,EAAE;IACD,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,sCA+FA"}