@skaile/workspaces 6.0.0 → 6.2.0

package/dist/{chunk-NOA6EJXE.js → chunk-PKE3PXOK.js}

@@ -79,7 +79,7 @@ function connectorUsageFragment(ctx) {
     "",
     ...rows,
     "",
-    "Access via `skaile res <id> <operation>` or the registered tool functions.",
+    "Access via `skaile connector ops <id>` to list a source's operations and `skaile connector run <id> <operation>` to run one, or the registered tool functions.",
     "Respect the declared access level \u2014 read-only resources must not be written to."
   ].join("\n");
 }
@@ -122,5 +122,5 @@ function loadPromptExtensions(paths, workspaceRoot) {
 }
 
 export { BUILT_IN_FRAGMENTS, loadPromptExtensions, resolveFragments };
-//# sourceMappingURL=chunk-NOA6EJXE.js.map
-//# sourceMappingURL=chunk-NOA6EJXE.js.map
+//# sourceMappingURL=chunk-PKE3PXOK.js.map
+//# sourceMappingURL=chunk-PKE3PXOK.js.map

package/dist/{chunk-NOA6EJXE.js.map → chunk-PKE3PXOK.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../asset-manager/src/fragments.ts"],"names":[],"mappings":"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","file":"chunk-NOA6EJXE.js","sourcesContent":["/**\n * Framework fragments — conditional system prompt sections injected by the\n * agent renderer at install time.\n *\n * Each fragment explains a specific aspect of the agent framework to the agent.\n * Fragments are conditional (return null when context is empty) and overridable\n * per project via skaile.yaml `agent.fragments`.\n */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\n/**\n * A skill installed into the agent's ability directory, referenced in the system prompt.\n *\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport interface AbilityRef {\n  /** Skill name used as the slash command (e.g. `\"code-review\"`). */\n  name: string;\n  /** One-line description shown in the `## Installed Abilities` section. */\n  description: string;\n}\n\n/**\n * A contract file installed alongside skills, referenced by path in the system prompt.\n *\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport interface ContractRef {\n  /** Contract name for display purposes. */\n  name: string;\n  /** Path relative to workspace root, e.g. `\".claude/skills/iron-laws/CONTRACT.md\"`. */\n  relativePath: string;\n}\n\n/**\n * A data connector declared in `skaile.yaml` resources.\n *\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport interface ConnectorRef {\n  /** Connector ID as declared in `skaile.yaml`. */\n  id: string;\n  /** Connector driver type (e.g. `\"postgres\"`, `\"redis\"`, `\"sqlite\"`). */\n  driver: string;\n  /** Declared access level (`\"read-only\"` or `\"read-write\"`). */\n  access: string;\n}\n\n/**\n * Context passed to each fragment function at render time.\n *\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport interface FragmentContext {\n  /** Agent framework ID (e.g. `\"claude-code\"`, `\"omp\"`, `\"codex\"`). */\n  framework: string;\n  /** Relative path to the framework's skill/ability directory, e.g. `\".claude/skills\"`. */\n  skillsDir: string;\n  /** Relative path to the framework's agent directory, e.g. `\".claude/agents\"`. */\n  agentsDir: string;\n  /** Sub-agent names from `manifest.requires[]`. */\n  subAgents: string[];\n  /**\n   * `true` when the agent is rendered to be called by another agent (a `delegate` sub-agent, or a\n   * `role`): it is told it is a sub-agent, not the workspace's only agent.\n   */\n  subAgent?: boolean;\n  /** Connectors declared in `skaile.yaml`. */\n  connectors: ConnectorRef[];\n  /** Resolved ability refs (installed skills). */\n  abilityRefs: AbilityRef[];\n  /** Resolved contract refs (installed alongside skills). */\n  contractRefs: ContractRef[];\n}\n\n/**\n * Identifier for a built-in system prompt fragment.\n * - `\"agent-mode\"` — describes whether the agent is a sole agent or an orchestrator.\n * - `\"handoff\"` — delegation guidelines injected when sub-agents are declared.\n * - `\"skill-discovery\"` — skill directory location injected when abilities are installed.\n * - `\"connector-usage\"` — connected resources list injected when connectors are declared.\n *\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport type FragmentId = \"agent-mode\" | \"handoff\" | \"skill-discovery\" | \"connector-usage\";\n\n// ── Built-in fragments ────────────────────────────────────────────────────────\n\nfunction agentModeFragment(ctx: FragmentContext): string | null {\n  if (ctx.subAgents.length === 0) {\n    if (ctx.subAgent) {\n      return [\n        \"## Operating Mode\",\n        \"\",\n        \"You are a sub-agent: another agent hands you one task at a time. Do exactly that\",\n        \"task with your installed abilities, and answer in the output format it asks for.\",\n        \"Do not take over the conversation or assume you are the only agent in the workspace.\",\n      ].join(\"\\n\");\n    }\n    return [\n      \"## Operating Mode\",\n      \"\",\n      \"You are the sole agent for this workspace. Complete tasks autonomously\",\n      \"using your installed abilities and connected resources.\",\n    ].join(\"\\n\");\n  }\n\n  const list = ctx.subAgents.map((n) => `- \\`${n}\\``).join(\"\\n\");\n  return [\n    \"## Operating Mode\",\n    \"\",\n    \"You are the orchestrator for this workspace. Coordinate specialized\",\n    \"sub-agents when tasks fall within their expertise:\",\n    \"\",\n    list,\n    \"\",\n    \"Delegate clearly: describe the task, expected output format, and any\",\n    \"constraints. Synthesize results before presenting to the user.\",\n  ].join(\"\\n\");\n}\n\nfunction handoffFragment(ctx: FragmentContext): string | null {\n  if (ctx.subAgents.length === 0) return null;\n\n  const lines = [\n    \"## Delegation\",\n    \"\",\n    \"When delegating to a sub-agent:\",\n    \"1. State the specific task and its acceptance criteria.\",\n    \"2. Provide relevant context the sub-agent cannot infer on its own.\",\n    \"3. Specify the expected output format.\",\n    \"4. If the result is incomplete, refine and retry once before escalating.\",\n  ];\n\n  if (ctx.framework === \"claude-code\") {\n    lines.push(\"\", `Use the Agent tool to dispatch. Sub-agents are in \\`${ctx.agentsDir}/\\`.`);\n  }\n\n  return lines.join(\"\\n\");\n}\n\nfunction skillDiscoveryFragment(ctx: FragmentContext): string | null {\n  if (ctx.abilityRefs.length === 0 && ctx.contractRefs.length === 0) return null;\n\n  const lines = [\n    \"## Skills and Abilities\",\n    \"\",\n    `Your specialized abilities are installed in \\`${ctx.skillsDir}/\\`.`,\n    \"Read a skill's SKILL.md before executing a task that matches its purpose.\",\n  ];\n\n  if (ctx.framework === \"claude-code\") {\n    lines.push(\"Abilities are also available as slash commands.\");\n  }\n\n  if (ctx.contractRefs.length > 0) {\n    lines.push(\n      \"\",\n      `Operational contracts are co-located in \\`${ctx.skillsDir}/\\`. Read the`,\n      \"relevant CONTRACT.md before acting on any constrained task.\",\n    );\n  }\n\n  return lines.join(\"\\n\");\n}\n\nfunction connectorUsageFragment(ctx: FragmentContext): string | null {\n  if (ctx.connectors.length === 0) return null;\n\n  const rows = ctx.connectors.map((c) => `- \\`${c.id}\\` (${c.driver}, ${c.access})`);\n\n  return [\n    \"## Connected Resources\",\n    \"\",\n    \"The following data sources are connected to this workspace:\",\n    \"\",\n    ...rows,\n    \"\",\n    \"Access via `skaile res <id> <operation>` or the registered tool functions.\",\n    \"Respect the declared access level — read-only resources must not be written to.\",\n  ].join(\"\\n\");\n}\n\n/**\n * Registry of all built-in fragment functions keyed by {@link FragmentId}.\n *\n * Each function receives a {@link FragmentContext} and returns the fragment markdown\n * to inject, or `null` when the fragment's condition is not met (e.g. `\"handoff\"`\n * returns `null` when there are no sub-agents).\n *\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport const BUILT_IN_FRAGMENTS: Record<FragmentId, (ctx: FragmentContext) => string | null> = {\n  \"agent-mode\": agentModeFragment,\n  handoff: handoffFragment,\n  \"skill-discovery\": skillDiscoveryFragment,\n  \"connector-usage\": connectorUsageFragment,\n};\n\n// ── Resolution ────────────────────────────────────────────────────────────────\n\n/**\n * Resolve all framework fragments for the rendered system prompt.\n *\n * Applies per-project overrides from `skaile.yaml` `agent.fragments`:\n * - `true` / absent → include built-in fragment (default)\n * - `false` → omit fragment\n * - `string` → load markdown from path relative to `workspaceRoot`\n *\n * @param ctx - Fragment context built from the agent manifest and workspace config.\n * @param overrides - Per-project overrides map from `skaile.yaml` `agent.fragments`.\n * @param workspaceRoot - Absolute path to the workspace root (for resolving custom fragment paths).\n * @returns Ordered list of resolved fragment markdown strings to inject into the system prompt.\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport function resolveFragments(\n  ctx: FragmentContext,\n  overrides: Record<string, boolean | string> | undefined,\n  workspaceRoot: string,\n): string[] {\n  const results: string[] = [];\n\n  for (const id of [\n    \"agent-mode\",\n    \"handoff\",\n    \"skill-discovery\",\n    \"connector-usage\",\n  ] as FragmentId[]) {\n    const override = overrides?.[id];\n\n    if (override === false) continue;\n\n    if (typeof override === \"string\") {\n      const filePath = resolve(workspaceRoot, override);\n      if (existsSync(filePath)) {\n        const content = readFileSync(filePath, \"utf-8\").trim();\n        if (content) results.push(content);\n      }\n      continue;\n    }\n\n    // true or absent — use built-in\n    const fragment = BUILT_IN_FRAGMENTS[id](ctx);\n    if (fragment) results.push(fragment);\n  }\n\n  return results;\n}\n\n/**\n * Load prompt-extension files declared under `skaile.yaml` `agent.prompt-extensions`.\n *\n * Paths are relative to `workspaceRoot`. Missing files are silently skipped.\n *\n * @param paths - Array of relative file paths from `skaile.yaml` `agent.prompt-extensions`.\n * @param workspaceRoot - Absolute path to the workspace root.\n * @returns Non-empty content strings for each file that exists and is non-empty.\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport function loadPromptExtensions(paths: string[] | undefined, workspaceRoot: string): string[] {\n  if (!paths?.length) return [];\n  return paths\n    .map((p) => {\n      const filePath = resolve(workspaceRoot, p);\n      if (!existsSync(filePath)) return null;\n      return readFileSync(filePath, \"utf-8\").trim();\n    })\n    .filter((s): s is string => s !== null && s.length > 0);\n}\n"]}
+{"version":3,"sources":["../asset-manager/src/fragments.ts"],"names":[],"mappings":"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","file":"chunk-PKE3PXOK.js","sourcesContent":["/**\n * Framework fragments — conditional system prompt sections injected by the\n * agent renderer at install time.\n *\n * Each fragment explains a specific aspect of the agent framework to the agent.\n * Fragments are conditional (return null when context is empty) and overridable\n * per project via skaile.yaml `agent.fragments`.\n */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\n/**\n * A skill installed into the agent's ability directory, referenced in the system prompt.\n *\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport interface AbilityRef {\n  /** Skill name used as the slash command (e.g. `\"code-review\"`). */\n  name: string;\n  /** One-line description shown in the `## Installed Abilities` section. */\n  description: string;\n}\n\n/**\n * A contract file installed alongside skills, referenced by path in the system prompt.\n *\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport interface ContractRef {\n  /** Contract name for display purposes. */\n  name: string;\n  /** Path relative to workspace root, e.g. `\".claude/skills/iron-laws/CONTRACT.md\"`. */\n  relativePath: string;\n}\n\n/**\n * A data connector declared in `skaile.yaml` resources.\n *\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport interface ConnectorRef {\n  /** Connector ID as declared in `skaile.yaml`. */\n  id: string;\n  /** Connector driver type (e.g. `\"postgres\"`, `\"redis\"`, `\"sqlite\"`). */\n  driver: string;\n  /** Declared access level (`\"read-only\"` or `\"read-write\"`). */\n  access: string;\n}\n\n/**\n * Context passed to each fragment function at render time.\n *\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport interface FragmentContext {\n  /** Agent framework ID (e.g. `\"claude-code\"`, `\"omp\"`, `\"codex\"`). */\n  framework: string;\n  /** Relative path to the framework's skill/ability directory, e.g. `\".claude/skills\"`. */\n  skillsDir: string;\n  /** Relative path to the framework's agent directory, e.g. `\".claude/agents\"`. */\n  agentsDir: string;\n  /** Sub-agent names from `manifest.requires[]`. */\n  subAgents: string[];\n  /**\n   * `true` when the agent is rendered to be called by another agent (a `delegate` sub-agent, or a\n   * `role`): it is told it is a sub-agent, not the workspace's only agent.\n   */\n  subAgent?: boolean;\n  /** Connectors declared in `skaile.yaml`. */\n  connectors: ConnectorRef[];\n  /** Resolved ability refs (installed skills). */\n  abilityRefs: AbilityRef[];\n  /** Resolved contract refs (installed alongside skills). */\n  contractRefs: ContractRef[];\n}\n\n/**\n * Identifier for a built-in system prompt fragment.\n * - `\"agent-mode\"` — describes whether the agent is a sole agent or an orchestrator.\n * - `\"handoff\"` — delegation guidelines injected when sub-agents are declared.\n * - `\"skill-discovery\"` — skill directory location injected when abilities are installed.\n * - `\"connector-usage\"` — connected resources list injected when connectors are declared.\n *\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport type FragmentId = \"agent-mode\" | \"handoff\" | \"skill-discovery\" | \"connector-usage\";\n\n// ── Built-in fragments ────────────────────────────────────────────────────────\n\nfunction agentModeFragment(ctx: FragmentContext): string | null {\n  if (ctx.subAgents.length === 0) {\n    if (ctx.subAgent) {\n      return [\n        \"## Operating Mode\",\n        \"\",\n        \"You are a sub-agent: another agent hands you one task at a time. Do exactly that\",\n        \"task with your installed abilities, and answer in the output format it asks for.\",\n        \"Do not take over the conversation or assume you are the only agent in the workspace.\",\n      ].join(\"\\n\");\n    }\n    return [\n      \"## Operating Mode\",\n      \"\",\n      \"You are the sole agent for this workspace. Complete tasks autonomously\",\n      \"using your installed abilities and connected resources.\",\n    ].join(\"\\n\");\n  }\n\n  const list = ctx.subAgents.map((n) => `- \\`${n}\\``).join(\"\\n\");\n  return [\n    \"## Operating Mode\",\n    \"\",\n    \"You are the orchestrator for this workspace. Coordinate specialized\",\n    \"sub-agents when tasks fall within their expertise:\",\n    \"\",\n    list,\n    \"\",\n    \"Delegate clearly: describe the task, expected output format, and any\",\n    \"constraints. Synthesize results before presenting to the user.\",\n  ].join(\"\\n\");\n}\n\nfunction handoffFragment(ctx: FragmentContext): string | null {\n  if (ctx.subAgents.length === 0) return null;\n\n  const lines = [\n    \"## Delegation\",\n    \"\",\n    \"When delegating to a sub-agent:\",\n    \"1. State the specific task and its acceptance criteria.\",\n    \"2. Provide relevant context the sub-agent cannot infer on its own.\",\n    \"3. Specify the expected output format.\",\n    \"4. If the result is incomplete, refine and retry once before escalating.\",\n  ];\n\n  if (ctx.framework === \"claude-code\") {\n    lines.push(\"\", `Use the Agent tool to dispatch. Sub-agents are in \\`${ctx.agentsDir}/\\`.`);\n  }\n\n  return lines.join(\"\\n\");\n}\n\nfunction skillDiscoveryFragment(ctx: FragmentContext): string | null {\n  if (ctx.abilityRefs.length === 0 && ctx.contractRefs.length === 0) return null;\n\n  const lines = [\n    \"## Skills and Abilities\",\n    \"\",\n    `Your specialized abilities are installed in \\`${ctx.skillsDir}/\\`.`,\n    \"Read a skill's SKILL.md before executing a task that matches its purpose.\",\n  ];\n\n  if (ctx.framework === \"claude-code\") {\n    lines.push(\"Abilities are also available as slash commands.\");\n  }\n\n  if (ctx.contractRefs.length > 0) {\n    lines.push(\n      \"\",\n      `Operational contracts are co-located in \\`${ctx.skillsDir}/\\`. Read the`,\n      \"relevant CONTRACT.md before acting on any constrained task.\",\n    );\n  }\n\n  return lines.join(\"\\n\");\n}\n\nfunction connectorUsageFragment(ctx: FragmentContext): string | null {\n  if (ctx.connectors.length === 0) return null;\n\n  const rows = ctx.connectors.map((c) => `- \\`${c.id}\\` (${c.driver}, ${c.access})`);\n\n  return [\n    \"## Connected Resources\",\n    \"\",\n    \"The following data sources are connected to this workspace:\",\n    \"\",\n    ...rows,\n    \"\",\n    \"Access via `skaile connector ops <id>` to list a source's operations and `skaile connector run <id> <operation>` to run one, or the registered tool functions.\",\n    \"Respect the declared access level — read-only resources must not be written to.\",\n  ].join(\"\\n\");\n}\n\n/**\n * Registry of all built-in fragment functions keyed by {@link FragmentId}.\n *\n * Each function receives a {@link FragmentContext} and returns the fragment markdown\n * to inject, or `null` when the fragment's condition is not met (e.g. `\"handoff\"`\n * returns `null` when there are no sub-agents).\n *\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport const BUILT_IN_FRAGMENTS: Record<FragmentId, (ctx: FragmentContext) => string | null> = {\n  \"agent-mode\": agentModeFragment,\n  handoff: handoffFragment,\n  \"skill-discovery\": skillDiscoveryFragment,\n  \"connector-usage\": connectorUsageFragment,\n};\n\n// ── Resolution ────────────────────────────────────────────────────────────────\n\n/**\n * Resolve all framework fragments for the rendered system prompt.\n *\n * Applies per-project overrides from `skaile.yaml` `agent.fragments`:\n * - `true` / absent → include built-in fragment (default)\n * - `false` → omit fragment\n * - `string` → load markdown from path relative to `workspaceRoot`\n *\n * @param ctx - Fragment context built from the agent manifest and workspace config.\n * @param overrides - Per-project overrides map from `skaile.yaml` `agent.fragments`.\n * @param workspaceRoot - Absolute path to the workspace root (for resolving custom fragment paths).\n * @returns Ordered list of resolved fragment markdown strings to inject into the system prompt.\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport function resolveFragments(\n  ctx: FragmentContext,\n  overrides: Record<string, boolean | string> | undefined,\n  workspaceRoot: string,\n): string[] {\n  const results: string[] = [];\n\n  for (const id of [\n    \"agent-mode\",\n    \"handoff\",\n    \"skill-discovery\",\n    \"connector-usage\",\n  ] as FragmentId[]) {\n    const override = overrides?.[id];\n\n    if (override === false) continue;\n\n    if (typeof override === \"string\") {\n      const filePath = resolve(workspaceRoot, override);\n      if (existsSync(filePath)) {\n        const content = readFileSync(filePath, \"utf-8\").trim();\n        if (content) results.push(content);\n      }\n      continue;\n    }\n\n    // true or absent — use built-in\n    const fragment = BUILT_IN_FRAGMENTS[id](ctx);\n    if (fragment) results.push(fragment);\n  }\n\n  return results;\n}\n\n/**\n * Load prompt-extension files declared under `skaile.yaml` `agent.prompt-extensions`.\n *\n * Paths are relative to `workspaceRoot`. Missing files are silently skipped.\n *\n * @param paths - Array of relative file paths from `skaile.yaml` `agent.prompt-extensions`.\n * @param workspaceRoot - Absolute path to the workspace root.\n * @returns Non-empty content strings for each file that exists and is non-empty.\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport function loadPromptExtensions(paths: string[] | undefined, workspaceRoot: string): string[] {\n  if (!paths?.length) return [];\n  return paths\n    .map((p) => {\n      const filePath = resolve(workspaceRoot, p);\n      if (!existsSync(filePath)) return null;\n      return readFileSync(filePath, \"utf-8\").trim();\n    })\n    .filter((s): s is string => s !== null && s.length > 0);\n}\n"]}

package/dist/{chunk-WYHQUCHR.js → chunk-PMWRM4EJ.js}

@@ -1,15 +1,15 @@
-import { requireValidPublisherOrExit } from './chunk-TKHJXPSB.js';
-import { openLibraryManager } from './chunk-DHYSUJ3H.js';
-import { logErr, logWarn, logInfo, logOk, S } from './chunk-KX2PT5Q4.js';
-import { getKindRegistry, getKnownKinds } from './chunk-ARWKK325.js';
-import { AssetManager } from './chunk-OAHVKSQJ.js';
-import { getStoreManifestsDir, storeManifestFile, LocalCatalogSource, curatedManifestOverlay, writeCuratedManifest, commitStoreManifest } from './chunk-UL22SDGR.js';
-import { computeDeterministicHash, discoverAssetsInTree } from './chunk-QOM5Z62G.js';
-import { WorkspaceYamlEditor } from './chunk-L4YKW5AY.js';
-import { findWorkspaceRoot, workspaceConfigFilename, sourceShortName, sourceCacheKey, getGlobalCacheDir, attachToBranch, resolveSourcePublisher, resolveSkWorkspaceConfig, priorSourceCacheKeys, buildProvenanceIndex, getRepoCommit } from './chunk-OHNKYHRR.js';
+import { requireValidPublisherOrExit } from './chunk-2XM3ZH36.js';
+import { openLibraryManager } from './chunk-BEYNH2LS.js';
+import { S, logErr, logWarn, logInfo, logOk } from './chunk-T2VBPVWZ.js';
+import { getKindRegistry, getKnownKinds } from './chunk-JJJ2G4K2.js';
+import { AssetManager } from './chunk-PKBLJI23.js';
+import { getStoreManifestsDir, storeManifestFile, LocalCatalogSource, curatedManifestOverlay, writeCuratedManifest, commitStoreManifest } from './chunk-6CYKTHNT.js';
+import { computeDeterministicHash, discoverAssetsInTree } from './chunk-MAZ3UXJK.js';
+import { WorkspaceYamlEditor } from './chunk-BRK5QZKI.js';
+import { findWorkspaceRoot, workspaceConfigFilename, sourceShortName, sourceCacheKey, getGlobalCacheDir, attachToBranch, resolveSourcePublisher, resolveSkWorkspaceConfig, priorSourceCacheKeys, buildProvenanceIndex, getRepoCommit } from './chunk-KJSC2ZD6.js';
 import { globalCacheRoot } from './chunk-L5VSIPQD.js';
-import { decodeSkaileManifest, encodeSkaileManifest } from './chunk-UQ33Y4DM.js';
-import { parseAssetRef } from './chunk-WDXZA7QW.js';
+import { decodeSkaileManifest, encodeSkaileManifest } from './chunk-KPKGWXUJ.js';
+import { parseAssetRef } from './chunk-IZQOO6MN.js';
 import { spawnSync } from 'child_process';
 import { existsSync, realpathSync, rmSync, renameSync, mkdirSync, statSync, readdirSync, rmdirSync, readFileSync, writeFileSync } from 'fs';
 import * as os from 'os';
@@ -22,11 +22,12 @@ function notWired(verb) {
   logErr(`${NOT_WIRED_MSG} (verb: source manifest ${verb})`);
   process.exit(2);
 }
-function resolveSourceArg(arg, projectDir) {
+function resolveSourceArg(arg, projectDir, opts = {}) {
   const root = findWorkspaceRoot(projectDir);
   const registered = root ? readProjectSources(path2.join(root, workspaceConfigFilename())) : [];
   const match = registered.find((e) => sourceMatchesKey(e, arg));
-  const bySlug = !match ? resolveByStoreSlug(arg) : void 0;
+  const found = !match ? resolveByStoreSlug(arg, opts.byName ?? true) : void 0;
+  const bySlug = found && "url" in found ? found : void 0;
   const url = match ? match.url : bySlug?.url ?? normalizeSourceUrl(arg);
   const slug = sourceShortName(url);
   const dest = sourceClonePath(sourceCacheKey(url));
@@ -35,16 +36,49 @@ function resolveSourceArg(arg, projectDir) {
     slug,
     dest,
     manifestFile: bySlug?.manifestFile ?? storeManifestPath(url),
-    guessed: !match && !bySlug
+    guessed: !match && !bySlug,
+    ...found && "ambiguous" in found ? { ambiguous: found.ambiguous } : {}
   };
 }
-function resolveByStoreSlug(arg) {
-  if (!/^[\w.-]+__[\w.-]+/.test(arg) || /[/:\\]/.test(arg)) return void 0;
-  const manifestFile = path2.join(getStoreManifestsDir(), `${arg}.yaml`);
-  if (!existsSync(manifestFile)) return void 0;
-  const [host, owner, repo] = arg.split("__");
-  const url = host && owner && repo ? `https://${host}/${owner}/${repo}` : arg;
-  return { url, manifestFile };
+function storeManifestSlugs() {
+  try {
+    return readdirSync(getStoreManifestsDir()).filter((f) => f.endsWith(".yaml")).map((f) => f.slice(0, -".yaml".length));
+  } catch {
+    return [];
+  }
+}
+function cloneOriginUrl(key) {
+  const dest = sourceClonePath(key);
+  if (!existsSync(dest)) return void 0;
+  const r = spawnSync("git", ["-C", dest, "remote", "get-url", "origin"], { encoding: "utf8" });
+  const out = r.status === 0 ? r.stdout.trim() : "";
+  return out || void 0;
+}
+function resolveByStoreSlug(arg, byName) {
+  if (!/^[\w.-]+$/.test(arg)) return void 0;
+  const slugs = storeManifestSlugs();
+  let slug = slugs.includes(arg) ? arg : void 0;
+  if (!slug && byName) {
+    const named = slugs.filter(
+      (s) => s.startsWith(`${arg}-`) && /^[0-9a-f]{8}$/.test(s.slice(arg.length + 1))
+    );
+    if (named.length === 1) slug = named[0];
+    else if (named.length > 1) return { ambiguous: [...named].sort() };
+  }
+  if (!slug) return void 0;
+  const manifestFile = path2.join(getStoreManifestsDir(), `${slug}.yaml`);
+  if (slug.includes("__")) {
+    const [host, owner, repo] = slug.split("__");
+    return { url: host && owner && repo ? `https://${host}/${owner}/${repo}` : slug, manifestFile };
+  }
+  const origin = cloneOriginUrl(slug);
+  return origin ? { url: origin, manifestFile } : void 0;
+}
+function missingManifestMessage(slug, manifestFile, ambiguous) {
+  if (ambiguous?.length) {
+    return `"${slug}" matches several curated manifests: ${ambiguous.join(", ")} \u2014 pass one of these slugs or the full source URL.`;
+  }
+  return `No curated manifest for "${slug}" at ${S.dim(manifestFile)} \u2014 run \`skaile source manifest init\` first.`;
 }
 function storeManifestPath(url) {
   return storeManifestFile(url);
@@ -63,7 +97,14 @@ function isTestFixtureAsset(relativePath) {
 }
 async function runInit(arg, opts) {
   const projectDir = path2.resolve(opts.projectDir);
-  const { url, dest, manifestFile: target, guessed } = resolveSourceArg(arg, projectDir);
+  const {
+    url,
+    dest,
+    manifestFile: target,
+    guessed
+  } = resolveSourceArg(arg, projectDir, {
+    byName: false
+  });
   if (guessed && /^[\w.-]+$/.test(arg.trim().replace(/\.git$/, ""))) {
     logErr(
       `"${arg}" is not a git URL or an owner/repo shorthand. Use \`skaile source manifest init <owner>/<repo>\` or the full URL.`
@@ -146,11 +187,9 @@ function entryRef(entry) {
 }
 async function runRebuild(arg, opts) {
   const projectDir = path2.resolve(opts.projectDir);
-  const { url, dest, slug, manifestFile: target } = resolveSourceArg(arg, projectDir);
+  const { url, dest, slug, manifestFile: target, ambiguous } = resolveSourceArg(arg, projectDir);
   if (!existsSync(target)) {
-    logErr(
-      `No curated manifest for "${slug}" at ${S.dim(target)} \u2014 run \`skaile source manifest init\` first.`
-    );
+    logErr(missingManifestMessage(slug, target, ambiguous));
     process.exit(1);
   }
   const entry = { url };
@@ -234,11 +273,9 @@ async function runRebuild(arg, opts) {
 }
 async function runVerify(arg, opts) {
   const projectDir = path2.resolve(opts.projectDir);
-  const { url, dest, slug, manifestFile: target } = resolveSourceArg(arg, projectDir);
+  const { url, dest, slug, manifestFile: target, ambiguous } = resolveSourceArg(arg, projectDir);
   if (!existsSync(target)) {
-    logErr(
-      `No curated manifest for "${slug}" at ${S.dim(target)} \u2014 run \`skaile source manifest init\` first.`
-    );
+    logErr(missingManifestMessage(slug, target, ambiguous));
     process.exit(1);
   }
   ensureClone({ url });
@@ -309,11 +346,9 @@ function resolveEditorCommand(editorEnv, target) {
 }
 function runEdit(arg, opts, spawn = spawnSync) {
   const projectDir = path2.resolve(opts.projectDir);
-  const { slug, manifestFile: target } = resolveSourceArg(arg, projectDir);
+  const { slug, manifestFile: target, ambiguous } = resolveSourceArg(arg, projectDir);
   if (!existsSync(target)) {
-    logErr(
-      `No curated manifest for "${slug}" at ${target}. Run \`skaile source manifest init\` first.`
-    );
+    logErr(missingManifestMessage(slug, target, ambiguous));
     process.exit(1);
   }
   const { command, args } = resolveEditorCommand(process.env.VISUAL || process.env.EDITOR, target);
@@ -345,12 +380,12 @@ function addSourceManifestCommands(src) {
   ).option("-C, --project-dir <dir>", "Project directory", process.cwd()).option("--publisher <name>", "Override the publisher (--overwrite only)").option("--dev", "Include assets under the source's dev_paths", false).option("--overwrite", "Discard curation and re-scan the full inventory", false).action((arg, opts) => runRebuild(arg, opts));
   manifest.command("verify <src>").description("Verify hashes, deps, and schema (read-only)").option("-C, --project-dir <dir>", "Project directory", process.cwd()).option("--strict", "Fail on advisory checks (warnings force a nonzero exit)", false).action((arg, opts) => runVerify(arg, opts));
   manifest.command("publish <src>").description("Push the curated sidecar manifest and publish it to the store").option("-C, --project-dir <dir>", "Project directory", process.cwd()).option("--as <namespace>", "Publisher namespace (default: your store username)").option("--sidecar-repo <url>", "Public GitHub repo you own to hold the curated manifest").option("--ref <gitref>", "Foreign source ref to ingest (branch/sha; default: main)").option("--dry-run", "Print the publish plan without pushing or calling the store", false).action(async (arg, opts) => {
-    const { runPublish } = await import('./source-manifest-publish-FK22TVQT.js');
+    const { runPublish } = await import('./source-manifest-publish-IYWUMUCY.js');
     await runPublish(arg, opts);
   });
   manifest.command("propose <src>").description("Open a PR to upstream with the sidecar manifest").action(() => notWired("propose"));
   manifest.command("yank <src>").description("Retract the source's published assets from the store").option("-C, --project-dir <dir>", "Project directory", process.cwd()).option("--asset <ref>", "Yank only the asset matching this ref/name").action(async (arg, opts) => {
-    const { runYank } = await import('./source-manifest-publish-FK22TVQT.js');
+    const { runYank } = await import('./source-manifest-publish-IYWUMUCY.js');
     await runYank(arg, opts);
   });
 }
@@ -410,11 +445,15 @@ function sourceLabel(entry, all) {
   const shared = all.some((s) => s.url !== entry.url && sourceShortName(s.url) === short);
   return shared ? sourceCacheKey(entry.url) : short;
 }
+function isLocalSourceUrl(url) {
+  return url.startsWith("/") || url.startsWith("file://");
+}
 function resolveSource(sources, key) {
   const tiers = [
     (s) => s.url === key,
     (s) => sourceCacheKey(s.url) === key,
-    (s) => sourceShortName(s.url) === key || s.url === normalizeSourceUrl(key)
+    (s) => sourceShortName(s.url) === key || s.url === normalizeSourceUrl(key),
+    (s) => isLocalSourceUrl(key) && isLocalSourceUrl(s.url) && realLocalCacheKey(s.url) === realLocalCacheKey(normalizeSourceUrl(key))
   ];
   for (const tier of tiers) {
     const hits = sources.filter(tier);
@@ -445,8 +484,18 @@ function logAdvisories(advisories, verbose, slug) {
   }
 }
 function findCacheKeyCollision(sources, url) {
-  const key = sourceCacheKey(url);
-  return sources.find((s) => s.url !== url && sourceCacheKey(s.url) === key);
+  const key = realLocalCacheKey(url);
+  return sources.find((s) => s.url !== url && realLocalCacheKey(s.url) === key);
+}
+function realLocalCacheKey(url) {
+  const local = url.startsWith("file://") ? url.slice("file://".length) : url;
+  if (local.startsWith("/") && existsSync(local)) {
+    try {
+      return sourceCacheKey(realpathSync(local));
+    } catch {
+    }
+  }
+  return sourceCacheKey(url);
 }
 function requireProjectYamlPath() {
   const root = findWorkspaceRoot(process.cwd());
@@ -458,10 +507,19 @@ function requireProjectYamlPath() {
   }
   return path2.join(root, workspaceConfigFilename());
 }
+function loadProjectEditor(yamlPath) {
+  try {
+    return WorkspaceYamlEditor.load(yamlPath);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    logErr(/ — parse error: /.test(message) ? message : `Could not read ${yamlPath}: ${message}`);
+    process.exit(1);
+  }
+}
 function readProjectSources(yamlPath) {
   if (!existsSync(yamlPath)) return [];
   try {
-    return WorkspaceYamlEditor.load(yamlPath).getSources();
+    return loadProjectEditor(yamlPath).getSources();
   } catch (err) {
     logErr(`Could not read ${yamlPath}: ${err instanceof Error ? err.message : String(err)}`);
     process.exit(1);
@@ -768,10 +826,12 @@ function makeSourceCommand() {
         process.exitCode = 1;
         return;
       }
-      const url = normalizeSourceUrl(source);
+      let url = normalizeSourceUrl(source);
       const yamlPath = requireProjectYamlPath();
       const collision = findCacheKeyCollision(readProjectSources(yamlPath), url);
-      if (collision) {
+      if (collision && isLocalSourceUrl(collision.url) && isLocalSourceUrl(url)) {
+        url = collision.url;
+      } else if (collision) {
         logErr(
           `"${url}" maps to the same cache key (${sourceCacheKey(url)}) as already-registered "${collision.url}". Remove that source first (skaile source remove) or re-use its exact URL to update it.`
         );
@@ -790,7 +850,8 @@ function makeSourceCommand() {
       if (opts.publisher) entry.publisher = requireValidPublisherOrExit(opts.publisher);
       const registered = readProjectSources(yamlPath).find((s) => s.url === url);
       const clonedAt = sourceClonePath(sourceCacheKey(url));
-      const publisherNow = registered && existsSync(clonedAt) ? resolveSourcePublisher(clonedAt, registered.publisher) : registered?.publisher;
+      const urlOrg = registered ? /github\.com[/:]([^/]+)\/[^/]+/.exec(registered.url)?.[1]?.toLowerCase() : void 0;
+      const publisherNow = registered && existsSync(clonedAt) ? resolveSourcePublisher(clonedAt, registered.publisher ?? urlOrg) : registered?.publisher ?? urlOrg;
       const publisherThen = registered && entry.publisher !== void 0 && existsSync(clonedAt) ? resolveSourcePublisher(clonedAt, entry.publisher) : entry.publisher;
       if (registered && publisherNow !== void 0 && entry.publisher !== void 0 && publisherNow !== publisherThen && !opts.force) {
         let declared = [];
@@ -826,7 +887,7 @@ function makeSourceCommand() {
       } else {
         logOk(`Cloned ${url} \u2192 ${dest}`);
       }
-      const editor = WorkspaceYamlEditor.load(yamlPath);
+      const editor = loadProjectEditor(yamlPath);
       editor.setSource(entry);
       editor.save();
       const result = await refreshManifestCache(entry, opts.dev);
@@ -902,7 +963,7 @@ function makeSourceCommand() {
     false
   ).option("--force", "Remove the source although a locked asset still comes from it", false).action(async (key, opts) => {
     const yamlPath = requireProjectYamlPath();
-    const editor = WorkspaceYamlEditor.load(yamlPath);
+    const editor = loadProjectEditor(yamlPath);
     const all = editor.getSources();
     const resolved = resolveSource(all, key);
     if (resolved.kind === "none") {
@@ -1011,6 +1072,6 @@ function makeSourceCommand() {
   return cmd;
 }
 
-export { autoSyncForSearch, divergedSourceClones, ensureClone, findCacheKeyCollision, indexingHadFailures, legacySourceConfigHint, localPathNotASource, makeSourceCommand, normalizeSourceUrl, pullSourceClone, readProjectSources, resolveSource, resolveSourceArg, restoreSourceReaders, sourceClonePath, sourceLabel, sourceMatchesKey, syncProjectSources };
-//# sourceMappingURL=chunk-WYHQUCHR.js.map
-//# sourceMappingURL=chunk-WYHQUCHR.js.map
+export { autoSyncForSearch, divergedSourceClones, ensureClone, findCacheKeyCollision, indexingHadFailures, legacySourceConfigHint, loadProjectEditor, localPathNotASource, makeSourceCommand, missingManifestMessage, normalizeSourceUrl, pullSourceClone, readProjectSources, resolveSource, resolveSourceArg, restoreSourceReaders, sourceClonePath, sourceLabel, sourceMatchesKey, syncProjectSources };
+//# sourceMappingURL=chunk-PMWRM4EJ.js.map
+//# sourceMappingURL=chunk-PMWRM4EJ.js.map