context-brake 1.0.0 → 1.1.0

package/dist/src/infrastructure/harnesses/claude-code/statusline-diagnostics.js

@@ -1,12 +1,12 @@
 import { readFile, realpath, stat } from 'node:fs/promises';
-import { join, relative, resolve } from 'node:path';
+import { relative, resolve } from 'node:path';
 import { resolveChangeTarget } from '../common/change-target.js';
 import { NodeProcessRunner } from '../../process/node-process-runner.js';
 import { normalizeSeparators } from '../../storage/path-boundary.js';
-import { getUserHome } from '../common/path-helpers.js';
 import { STATUSLINE_PIPE_FLAG } from './statusline-bridge.js';
 import { lastRecordedShell, localStatuslineCommand } from './statusline-context-window.js';
 import { CLAUDE_LOCAL_SETTINGS_FILE, CLAUDE_SETTINGS_FILE, firstPreviousStatusline, readSettings, STATUSLINE_BRIDGE_FILE, statuslineOf } from './statusline-settings.js';
+import { claudeUserSettingsPath } from './user-settings.js';
 import { parseStatuslineState, STATUSLINE_STATE_FILE } from './statusline-state.js';
 const GIT_TIMEOUT_MILLISECONDS = 2000;
 const GIT_NOT_IGNORED_EXIT_CODE = 1;
@@ -47,7 +47,7 @@ async function isScriptPresent(state) {
 }
 async function currentPreviousCommand(context, state) {
     const project = await readSettings(resolve(context.projectRoot, CLAUDE_SETTINGS_FILE));
-    const user = await readSettings(join(getUserHome(context.userHome), CLAUDE_SETTINGS_FILE));
+    const user = await readSettings(claudeUserSettingsPath(context.userHome));
     const previous = firstPreviousStatusline([{ source: 'local', value: state.previousLocal ?? undefined }, { source: 'project', value: statuslineOf(project) }, { source: 'user', value: statuslineOf(user) }]);
     return previous?.command ?? null;
 }

package/dist/src/infrastructure/harnesses/claude-code/statusline-migration.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessContext } from '../../../core/contracts/adapter.js';
+import { type StatuslinePlan } from './statusline-restore.js';
+export declare function planModFirstStatusline(context: HarnessContext): Promise<StatuslinePlan>;

package/dist/src/infrastructure/harnesses/claude-code/statusline-migration.js

@@ -0,0 +1,23 @@
+import { resolve } from 'node:path';
+import { resolveChangeTarget } from '../common/change-target.js';
+import { pathExists } from '../common/path-helpers.js';
+import { planStatuslineOptOut, softenDefaultConflict } from './statusline-default.js';
+import { planStatuslineRestore } from './statusline-restore.js';
+import { STATUSLINE_BRIDGE_FILE } from './statusline-settings.js';
+async function bridgeScriptDeletion(projectRoot) {
+    if (!(await pathExists(resolve(projectRoot, STATUSLINE_BRIDGE_FILE))))
+        return [];
+    const realPath = await resolveChangeTarget(projectRoot, STATUSLINE_BRIDGE_FILE);
+    return [{ path: STATUSLINE_BRIDGE_FILE, realPath, kind: 'delete', owner: 'runtime_asset', content: null, preview: { summary: 'Delete the status line bridge script, the mod now reads the context' } }];
+}
+async function restoration(context) {
+    if (context.statuslineBridge === 'remove')
+        return planStatuslineOptOut(context.projectRoot);
+    return softenDefaultConflict(await planStatuslineRestore(context.projectRoot));
+}
+export async function planModFirstStatusline(context) {
+    const restore = await restoration(context);
+    if (restore.conflicts.length > 0)
+        return restore;
+    return { ...restore, changes: [...restore.changes, ...await bridgeScriptDeletion(context.projectRoot)] };
+}

package/dist/src/infrastructure/harnesses/claude-code/statusline-planner.d.ts

@@ -1,4 +1,5 @@
 import type { HarnessContext } from '../../../core/contracts/adapter.js';
+import type { ContextSource } from './context-source.js';
 import { type StatuslinePlan } from './statusline-restore.js';
-export declare function planStatuslineInstall(context: HarnessContext): Promise<StatuslinePlan>;
+export declare function planStatuslineInstall(context: HarnessContext, source: ContextSource): Promise<StatuslinePlan>;
 export declare function planStatuslineRemove(projectRoot: string): Promise<StatuslinePlan>;

package/dist/src/infrastructure/harnesses/claude-code/statusline-planner.js

@@ -1,17 +1,20 @@
 import { realpath } from 'node:fs/promises';
-import { join, resolve } from 'node:path';
+import { resolve } from 'node:path';
 import { setJsonProperty } from '../../storage/json-document-editor.js';
 import { resolveChangeTarget } from '../common/change-target.js';
 import { loadRuntimeAsset } from '../common/runtime-assets.js';
-import { getUserHome } from '../common/path-helpers.js';
 import { asRecord } from '../common/runtime-support.js';
 import { clearStatuslineOptOut, hasStatuslineOptOut, planStatuslineOptOut, softenDefaultConflict } from './statusline-default.js';
+import { planModFirstStatusline } from './statusline-migration.js';
 import { planStatuslineRestore, statuslinePlanConflict } from './statusline-restore.js';
 import { bridgeCommand, CLAUDE_LOCAL_SETTINGS_FILE, CLAUDE_SETTINGS_FILE, firstPreviousStatusline, isBridgeStatusline, readSettings, STATUSLINE_BRIDGE_FILE, STATUSLINE_KEY, statuslineOf, statuslineOptions, toCommandRoot } from './statusline-settings.js';
+import { claudeUserSettingsPath } from './user-settings.js';
 import { readStatuslineState, serializeStatuslineState, STATUSLINE_STATE_FILE } from './statusline-state.js';
 const EMPTY_SETTINGS_TEXT = '{\n}\n';
 const EMPTY_PLAN = { changes: [], conflicts: [], findings: [] };
-export async function planStatuslineInstall(context) {
+export async function planStatuslineInstall(context, source) {
+    if (source === 'mod')
+        return planModFirstStatusline(context);
     const plan = context.statuslineBridge === 'remove' ? await planStatuslineOptOut(context.projectRoot) : await requestedEntry(context);
     return { ...plan, changes: [await bridgeAssetChange(context.projectRoot), ...plan.changes] };
 }
@@ -51,7 +54,7 @@ async function resolveOrigin(context, local, state) {
     const project = await readSettings(resolve(context.projectRoot, CLAUDE_SETTINGS_FILE));
     if (project.kind === 'invalid')
         return statuslinePlanConflict(CLAUDE_SETTINGS_FILE, project.detail);
-    const user = await readSettings(join(getUserHome(context.userHome), CLAUDE_SETTINGS_FILE));
+    const user = await readSettings(claudeUserSettingsPath(context.userHome));
     const localValue = local.kind === 'valid' && !isBridgeStatusline(local.statusLine) ? local.statusLine : undefined;
     const previous = firstPreviousStatusline([{ source: 'local', value: localValue }, { source: 'project', value: statuslineOf(project) }, { source: 'user', value: statuslineOf(user) }]);
     const previousLocal = asRecord(localValue);

package/dist/src/infrastructure/harnesses/claude-code/user-settings.d.ts

@@ -0,0 +1,2 @@
+export declare const CLAUDE_CONFIG_DIR_VARIABLE = "CLAUDE_CONFIG_DIR";
+export declare function claudeUserSettingsPath(injectedUserHome?: string): string;

package/dist/src/infrastructure/harnesses/claude-code/user-settings.js

@@ -0,0 +1,11 @@
+import { join } from 'node:path';
+import { getUserHome } from '../common/path-helpers.js';
+import { CLAUDE_SETTINGS_FILE } from './statusline-settings.js';
+export const CLAUDE_CONFIG_DIR_VARIABLE = 'CLAUDE_CONFIG_DIR';
+const USER_SETTINGS_FILE_NAME = 'settings.json';
+export function claudeUserSettingsPath(injectedUserHome) {
+    const configDirectory = process.env[CLAUDE_CONFIG_DIR_VARIABLE]?.trim();
+    if (injectedUserHome === undefined && configDirectory !== undefined && configDirectory !== '')
+        return join(configDirectory, USER_SETTINGS_FILE_NAME);
+    return join(getUserHome(injectedUserHome), CLAUDE_SETTINGS_FILE);
+}

package/dist/src/infrastructure/harnesses/codex-cli/adapter.js

@@ -3,6 +3,7 @@ import { resolve } from 'node:path';
 import { deriveSupportProfile } from '../../../core/services/support-service.js';
 import { validateJsonDocument } from '../../storage/json-validator.js';
 import { createAssetMissingFinding, createCodexRootNotGitWarning, createIntegrationMissingFinding, createInvalidConfigFinding, createLimitationFinding, } from '../common/diagnostic-helpers.js';
+import { applyConfigOrigin, attachConfigOrigin } from '../common/config-origin.js';
 import { pathExists } from '../common/path-helpers.js';
 import { probeExecutableVersion } from '../common/version-probes.js';
 import { CODEX_CAPABILITIES } from './capabilities.js';
@@ -47,11 +48,11 @@ export class CodexAdapter {
     probeVersion(context) {
         return probeExecutableVersion(context.runner, CODEX_EXECUTABLES);
     }
-    planInstall(context) {
-        return planCodexInstall(context.projectRoot);
+    async planInstall(context) {
+        return attachConfigOrigin(await planCodexInstall(context.projectRoot), { path: CODEX_CONFIG_FILE, manifest: context.manifest });
     }
-    planRemove(context) {
-        return planCodexRemove(context.projectRoot);
+    async planRemove(context) {
+        return applyConfigOrigin(await planCodexRemove(context.projectRoot), { path: CODEX_CONFIG_FILE, manifest: context.manifest });
     }
     async diagnose(context) {
         const findings = [];

package/dist/src/infrastructure/harnesses/codex-cli/runtime.js

@@ -1,3 +1,4 @@
+import { CODEX_SKILL_INVOCATION } from './skill-invocation.js';
 import { failureDetail, recordRuntimeFailure } from '../../../core/services/failure-policy.js';
 import { asRecord, assetProjectRoot, characterLength, parsePayload, requireIdentifier, textValue } from '../common/runtime-support.js';
 import { runProcessHook } from '../../runtime/process-hook-host.js';
@@ -7,7 +8,7 @@ import { codexPayloadSchema } from './schemas.js';
 const HARNESS = 'codex-cli';
 const ESTIMATION = { baselineTokens: 15000, tokensPerTurn: 150 };
 const PATCH_PATH_PREFIXES = ['*** Add File: ', '*** Update File: ', '*** Delete File: ', '*** Move to: '];
-export const codexDescriptor = { harness: HARNESS, capabilities: CODEX_CAPABILITIES, estimation: ESTIMATION, newSessionCommand: '/new' };
+export const codexDescriptor = { harness: HARNESS, capabilities: CODEX_CAPABILITIES, estimation: ESTIMATION, newSessionCommand: '/new', skillInvocation: CODEX_SKILL_INVOCATION };
 function sessionOf(payload) {
     return { harness: HARNESS, sessionId: requireIdentifier(payload.session_id), agentId: payload.agent_id ?? null };
 }

package/dist/src/infrastructure/harnesses/codex-cli/skill-folders.d.ts

@@ -0,0 +1 @@
+export declare const CODEX_SKILL_FOLDERS: readonly string[];

package/dist/src/infrastructure/harnesses/codex-cli/skill-folders.js

@@ -0,0 +1 @@
+export const CODEX_SKILL_FOLDERS = ['.agents/skills'];

package/dist/src/infrastructure/harnesses/codex-cli/skill-invocation.d.ts

@@ -0,0 +1,2 @@
+import type { SkillInvocationFormat } from '../../../core/contracts/skill-invocation.js';
+export declare const CODEX_SKILL_INVOCATION: SkillInvocationFormat;

package/dist/src/infrastructure/harnesses/codex-cli/skill-invocation.js

@@ -0,0 +1,2 @@
+import { dollarInvocation } from '../../../core/services/skill-invocation.js';
+export const CODEX_SKILL_INVOCATION = dollarInvocation;

package/dist/src/infrastructure/harnesses/common/config-origin.d.ts

@@ -0,0 +1,10 @@
+import type { AdapterPlan } from '../../../core/contracts/adapter.js';
+import type { InstallationManifest } from '../../../core/contracts/manifest.js';
+export type ScalarDefaults = Readonly<Record<string, string | number | boolean>>;
+export type OriginTarget = {
+    readonly path: string;
+    readonly manifest?: InstallationManifest | null | undefined;
+    readonly defaults?: ScalarDefaults;
+};
+export declare function attachConfigOrigin(plan: AdapterPlan, target: OriginTarget): Promise<AdapterPlan>;
+export declare function applyConfigOrigin(plan: AdapterPlan, target: OriginTarget): AdapterPlan;

package/dist/src/infrastructure/harnesses/common/config-origin.js

@@ -0,0 +1,52 @@
+import { readFile } from 'node:fs/promises';
+import { findNodeAtLocation, getNodeValue, parseTree } from 'jsonc-parser';
+import { parseAndValidateJson, removeJsonProperty } from '../../storage/json-document-editor.js';
+function topLevelKeys(text) {
+    const root = parseTree(text, [], { disallowComments: false });
+    if (root?.type !== 'object')
+        return [];
+    return (root.children ?? []).map((property) => String(property.children?.[0]?.value));
+}
+function isEmptyContainer(value) {
+    if (Array.isArray(value))
+        return value.length === 0;
+    return typeof value === 'object' && value !== null && Object.keys(value).length === 0;
+}
+function removeAddedKeys(text, origin, defaults) {
+    return origin.addedKeys.reduce((current, key) => {
+        const node = findNodeAtLocation(parseAndValidateJson(current), [key]);
+        if (!node)
+            return current;
+        const value = getNodeValue(node);
+        return isEmptyContainer(value) || value === defaults[key] ? removeJsonProperty(current, [key]) : current;
+    }, text);
+}
+function restoreChange(change, origin, defaults) {
+    if (change.path !== origin.path || change.kind !== 'update' || change.content === null)
+        return change;
+    const content = removeAddedKeys(change.content, origin, defaults);
+    if (origin.created && /^\s*\{\s*\}\s*$/.test(content))
+        return { ...change, kind: 'delete', content: null, preview: { summary: `Delete ${origin.path}, created by init` } };
+    return { ...change, content };
+}
+function recordConfigOrigin(target, original, installed) {
+    const path = target.path;
+    const recorded = target.manifest?.configOrigins?.find((origin) => origin.path === path);
+    if (recorded)
+        return recorded;
+    const before = new Set(original === null ? [] : topLevelKeys(original));
+    return { path, created: original === null, addedKeys: topLevelKeys(installed).filter((key) => !before.has(key)) };
+}
+export async function attachConfigOrigin(plan, target) {
+    const change = plan.changes.find((item) => item.path === target.path);
+    if (!change || change.content === null)
+        return plan;
+    const original = await readFile(change.realPath, 'utf8').catch(() => null);
+    return { ...plan, configOrigins: [recordConfigOrigin(target, original, change.content)] };
+}
+export function applyConfigOrigin(plan, target) {
+    const origin = target.manifest?.configOrigins?.find((item) => item.path === target.path);
+    if (!origin)
+        return plan;
+    return { ...plan, changes: plan.changes.map((change) => restoreChange(change, origin, target.defaults ?? {})) };
+}

package/dist/src/infrastructure/harnesses/cursor/adapter.js

@@ -4,6 +4,7 @@ import {} from '../../../core/contracts/harness.js';
 import { deriveSupportProfile } from '../../../core/services/support-service.js';
 import { validateJsonDocument } from '../../storage/json-validator.js';
 import { createAssetMissingFinding, createIntegrationMissingFinding, createInvalidConfigFinding } from '../common/diagnostic-helpers.js';
+import { applyConfigOrigin, attachConfigOrigin } from '../common/config-origin.js';
 import { pathExists } from '../common/path-helpers.js';
 import { probeExecutableVersion } from '../common/version-probes.js';
 import { CURSOR_CAPABILITIES } from './capabilities.js';
@@ -21,11 +22,11 @@ export class CursorAdapter {
     probeVersion(context) {
         return probeExecutableVersion(context.runner, CURSOR_EXECUTABLES);
     }
-    planInstall(context) {
-        return planCursorInstall(context.projectRoot);
+    async planInstall(context) {
+        return attachConfigOrigin(await planCursorInstall(context.projectRoot), { path: CURSOR_CONFIG_FILE, manifest: context.manifest });
     }
-    planRemove(context) {
-        return planCursorRemove(context.projectRoot);
+    async planRemove(context) {
+        return applyConfigOrigin(await planCursorRemove(context.projectRoot), { path: CURSOR_CONFIG_FILE, manifest: context.manifest, defaults: { version: 1 } });
     }
     async diagnose(context) {
         const findings = [];

package/dist/src/infrastructure/harnesses/cursor/runtime.js

@@ -1,10 +1,11 @@
+import { CURSOR_SKILL_INVOCATION } from './skill-invocation.js';
 import { asRecord, assetProjectRoot, characterLength, parsePayload, projectRootFromEnvironment, requireIdentifier, textValue } from '../common/runtime-support.js';
 import { runProcessHook } from '../../runtime/process-hook-host.js';
 import { CURSOR_CAPABILITIES } from './capabilities.js';
 import { cursorPayloadSchema } from './schemas.js';
 const HARNESS = 'cursor';
 const ESTIMATION = { baselineTokens: 15000, tokensPerTurn: 150 };
-export const cursorDescriptor = { harness: HARNESS, capabilities: CURSOR_CAPABILITIES, estimation: ESTIMATION, newSessionCommand: null };
+export const cursorDescriptor = { harness: HARNESS, capabilities: CURSOR_CAPABILITIES, estimation: ESTIMATION, newSessionCommand: null, skillInvocation: CURSOR_SKILL_INVOCATION };
 function sessionOf(payload) {
     const sessionId = payload.session_id ?? payload.conversation_id;
     return { harness: HARNESS, sessionId: requireIdentifier(sessionId), agentId: null };

package/dist/src/infrastructure/harnesses/cursor/skill-folders.d.ts

@@ -0,0 +1 @@
+export declare const CURSOR_SKILL_FOLDERS: readonly string[];

package/dist/src/infrastructure/harnesses/cursor/skill-folders.js

@@ -0,0 +1 @@
+export const CURSOR_SKILL_FOLDERS = ['.cursor/skills', '.agents/skills', '.claude/skills', '.codex/skills'];

package/dist/src/infrastructure/harnesses/cursor/skill-invocation.d.ts

@@ -0,0 +1,2 @@
+import type { SkillInvocationFormat } from '../../../core/contracts/skill-invocation.js';
+export declare const CURSOR_SKILL_INVOCATION: SkillInvocationFormat;

package/dist/src/infrastructure/harnesses/cursor/skill-invocation.js

@@ -0,0 +1,2 @@
+import { slashInvocation } from '../../../core/services/skill-invocation.js';
+export const CURSOR_SKILL_INVOCATION = slashInvocation;

package/dist/src/infrastructure/harnesses/github-copilot-cli/runtime.js

@@ -1,3 +1,4 @@
+import { COPILOT_SKILL_INVOCATION } from './skill-invocation.js';
 import { asRecord, assetProjectRoot, characterLength, parsePayload, requireIdentifier, textValue } from '../common/runtime-support.js';
 import { runProcessHook } from '../../runtime/process-hook-host.js';
 import { COPILOT_CAPABILITIES } from './capabilities.js';
@@ -7,7 +8,7 @@ const ESTIMATION = { baselineTokens: 15000, tokensPerTurn: 150 };
 const READ_TOOLS = ['view'];
 const WRITE_TOOLS = ['edit', 'create'];
 const SHELL_TOOLS = ['bash', 'powershell'];
-export const copilotDescriptor = { harness: HARNESS, capabilities: COPILOT_CAPABILITIES, estimation: ESTIMATION, newSessionCommand: null };
+export const copilotDescriptor = { harness: HARNESS, capabilities: COPILOT_CAPABILITIES, estimation: ESTIMATION, newSessionCommand: null, skillInvocation: COPILOT_SKILL_INVOCATION };
 function sessionOf(payload) {
     return { harness: HARNESS, sessionId: requireIdentifier(payload.sessionId), agentId: null };
 }

package/dist/src/infrastructure/harnesses/github-copilot-cli/skill-folders.d.ts

@@ -0,0 +1 @@
+export declare const COPILOT_SKILL_FOLDERS: readonly string[];

package/dist/src/infrastructure/harnesses/github-copilot-cli/skill-folders.js

@@ -0,0 +1 @@
+export const COPILOT_SKILL_FOLDERS = ['.github/skills', '.claude/skills', '.agents/skills'];

package/dist/src/infrastructure/harnesses/github-copilot-cli/skill-invocation.d.ts

@@ -0,0 +1,2 @@
+import type { SkillInvocationFormat } from '../../../core/contracts/skill-invocation.js';
+export declare const COPILOT_SKILL_INVOCATION: SkillInvocationFormat;

package/dist/src/infrastructure/harnesses/github-copilot-cli/skill-invocation.js

@@ -0,0 +1,2 @@
+import { slashInvocation } from '../../../core/services/skill-invocation.js';
+export const COPILOT_SKILL_INVOCATION = slashInvocation;

package/dist/src/infrastructure/harnesses/oh-my-pi/runtime.js

@@ -1,3 +1,4 @@
+import { OMP_SKILL_INVOCATION } from './skill-invocation.js';
 import { createRuntimeResolver, measuredUsageFrom, runInProcessEvent } from '../common/in-process-support.js';
 import { requireIdentifier, textValue } from '../common/runtime-support.js';
 import { OMP_CAPABILITIES } from './capabilities.js';
@@ -5,7 +6,7 @@ import { mapOmpEvent, mapOmpInput, renderOmpToolResult } from './events.js';
 export { mapOmpEvent, mapOmpInput, renderOmpToolResult } from './events.js';
 const HARNESS = 'oh-my-pi';
 const ESTIMATION = { baselineTokens: 15000, tokensPerTurn: 150 };
-export const ompDescriptor = { harness: HARNESS, capabilities: OMP_CAPABILITIES, estimation: ESTIMATION, newSessionCommand: '/new' };
+export const ompDescriptor = { harness: HARNESS, capabilities: OMP_CAPABILITIES, estimation: ESTIMATION, newSessionCommand: '/new', skillInvocation: OMP_SKILL_INVOCATION };
 function rootOf(context) {
     return textValue(context.cwd);
 }

package/dist/src/infrastructure/harnesses/oh-my-pi/skill-folders.d.ts

@@ -0,0 +1 @@
+export declare const OMP_SKILL_FOLDERS: readonly string[];

package/dist/src/infrastructure/harnesses/oh-my-pi/skill-folders.js

@@ -0,0 +1 @@
+export const OMP_SKILL_FOLDERS = ['.omp/skills', '.github/skills', '.agents/skills'];

package/dist/src/infrastructure/harnesses/oh-my-pi/skill-invocation.d.ts

@@ -0,0 +1,2 @@
+import type { SkillInvocationFormat } from '../../../core/contracts/skill-invocation.js';
+export declare const OMP_SKILL_INVOCATION: SkillInvocationFormat;

package/dist/src/infrastructure/harnesses/oh-my-pi/skill-invocation.js

@@ -0,0 +1,2 @@
+import { sentenceInvocation } from '../../../core/services/skill-invocation.js';
+export const OMP_SKILL_INVOCATION = sentenceInvocation;

package/dist/src/infrastructure/harnesses/opencode/runtime.js

@@ -1,3 +1,4 @@
+import { OPENCODE_SKILL_INVOCATION } from './skill-invocation.js';
 import { createRuntimeResolver, runInProcessEvent } from '../common/in-process-support.js';
 import { asRecord, parsePayload, textValue } from '../common/runtime-support.js';
 import { OPENCODE_CAPABILITIES } from './capabilities.js';
@@ -7,7 +8,7 @@ export { mapOpenCodeSessionEvent, mapOpenCodeToolResult, openCodeObservedCharact
 const HARNESS = 'opencode';
 const ESTIMATION = { baselineTokens: 15000, tokensPerTurn: 150 };
 const FALLBACK_SESSION_ID = 'project';
-export const openCodeDescriptor = { harness: HARNESS, capabilities: OPENCODE_CAPABILITIES, estimation: ESTIMATION, newSessionCommand: null };
+export const openCodeDescriptor = { harness: HARNESS, capabilities: OPENCODE_CAPABILITIES, estimation: ESTIMATION, newSessionCommand: null, skillInvocation: OPENCODE_SKILL_INVOCATION };
 function resolveProjectRoot(context) {
     const record = asRecord(context);
     return textValue(record?.['directory']) ?? textValue(record?.['worktree']) ?? process.cwd();

package/dist/src/infrastructure/harnesses/opencode/skill-folders.d.ts

@@ -0,0 +1 @@
+export declare const OPENCODE_SKILL_FOLDERS: readonly string[];

package/dist/src/infrastructure/harnesses/opencode/skill-folders.js

@@ -0,0 +1 @@
+export const OPENCODE_SKILL_FOLDERS = ['.opencode/skills', '.claude/skills', '.agents/skills'];

package/dist/src/infrastructure/harnesses/opencode/skill-invocation.d.ts

@@ -0,0 +1,2 @@
+import type { SkillInvocationFormat } from '../../../core/contracts/skill-invocation.js';
+export declare const OPENCODE_SKILL_INVOCATION: SkillInvocationFormat;

package/dist/src/infrastructure/harnesses/opencode/skill-invocation.js

@@ -0,0 +1,2 @@
+import { sentenceInvocation } from '../../../core/services/skill-invocation.js';
+export const OPENCODE_SKILL_INVOCATION = sentenceInvocation;

package/dist/src/infrastructure/harnesses/pi/runtime.js

@@ -1,3 +1,4 @@
+import { PI_SKILL_INVOCATION } from './skill-invocation.js';
 import { createRuntimeResolver, measuredUsageFrom, runInProcessEvent } from '../common/in-process-support.js';
 import { requireIdentifier, textValue } from '../common/runtime-support.js';
 import { PI_CAPABILITIES } from './capabilities.js';
@@ -5,7 +6,7 @@ import { mapPiEvent, mapPiInput, renderPiToolResult } from './events.js';
 export { mapPiEvent, mapPiInput, renderPiToolResult } from './events.js';
 const HARNESS = 'pi';
 const ESTIMATION = { baselineTokens: 15000, tokensPerTurn: 150 };
-export const piDescriptor = { harness: HARNESS, capabilities: PI_CAPABILITIES, estimation: ESTIMATION, newSessionCommand: '/new' };
+export const piDescriptor = { harness: HARNESS, capabilities: PI_CAPABILITIES, estimation: ESTIMATION, newSessionCommand: '/new', skillInvocation: PI_SKILL_INVOCATION };
 function rootOf(context) {
     return textValue(context.cwd);
 }

package/dist/src/infrastructure/harnesses/pi/skill-folders.d.ts

@@ -0,0 +1 @@
+export declare const PI_SKILL_FOLDERS: readonly string[];

package/dist/src/infrastructure/harnesses/pi/skill-folders.js

@@ -0,0 +1 @@
+export const PI_SKILL_FOLDERS = ['.pi/skills', '.agents/skills'];

package/dist/src/infrastructure/harnesses/pi/skill-invocation.d.ts

@@ -0,0 +1,2 @@
+import type { SkillInvocationFormat } from '../../../core/contracts/skill-invocation.js';
+export declare const PI_SKILL_INVOCATION: SkillInvocationFormat;

package/dist/src/infrastructure/harnesses/pi/skill-invocation.js

@@ -0,0 +1,2 @@
+import { skillSlashInvocation } from '../../../core/services/skill-invocation.js';
+export const PI_SKILL_INVOCATION = skillSlashInvocation;

package/dist/src/infrastructure/harnesses/skill-folders.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessId } from '../../core/contracts/harness.js';
+export declare const SKILL_FOLDERS: Readonly<Record<HarnessId, readonly string[]>>;
+export declare function resolveSkillFolders(harness: HarnessId): readonly string[];

package/dist/src/infrastructure/harnesses/skill-folders.js

@@ -0,0 +1,21 @@
+import { CLAUDE_SKILL_FOLDERS } from './claude-code/skill-folders.js';
+import { CODEX_SKILL_FOLDERS } from './codex-cli/skill-folders.js';
+import { CURSOR_SKILL_FOLDERS } from './cursor/skill-folders.js';
+import { COPILOT_SKILL_FOLDERS } from './github-copilot-cli/skill-folders.js';
+import { OPENCODE_SKILL_FOLDERS } from './opencode/skill-folders.js';
+import { PI_SKILL_FOLDERS } from './pi/skill-folders.js';
+import { OMP_SKILL_FOLDERS } from './oh-my-pi/skill-folders.js';
+import { ANTIGRAVITY_SKILL_FOLDERS } from './antigravity-cli/skill-folders.js';
+export const SKILL_FOLDERS = {
+    'claude-code': CLAUDE_SKILL_FOLDERS,
+    'codex-cli': CODEX_SKILL_FOLDERS,
+    cursor: CURSOR_SKILL_FOLDERS,
+    'github-copilot-cli': COPILOT_SKILL_FOLDERS,
+    opencode: OPENCODE_SKILL_FOLDERS,
+    pi: PI_SKILL_FOLDERS,
+    'oh-my-pi': OMP_SKILL_FOLDERS,
+    'antigravity-cli': ANTIGRAVITY_SKILL_FOLDERS,
+};
+export function resolveSkillFolders(harness) {
+    return SKILL_FOLDERS[harness];
+}

package/dist/src/infrastructure/harnesses/skill-invocations.d.ts

@@ -0,0 +1,4 @@
+import type { HarnessId } from '../../core/contracts/harness.js';
+import type { SkillInvocationFormat } from '../../core/contracts/skill-invocation.js';
+export declare const SKILL_INVOCATIONS: Readonly<Record<HarnessId, SkillInvocationFormat>>;
+export declare function resolveSkillInvocation(harness: HarnessId): SkillInvocationFormat;

package/dist/src/infrastructure/harnesses/skill-invocations.js

@@ -0,0 +1,21 @@
+import { ANTIGRAVITY_SKILL_INVOCATION } from './antigravity-cli/skill-invocation.js';
+import { CLAUDE_SKILL_INVOCATION } from './claude-code/skill-invocation.js';
+import { CODEX_SKILL_INVOCATION } from './codex-cli/skill-invocation.js';
+import { CURSOR_SKILL_INVOCATION } from './cursor/skill-invocation.js';
+import { COPILOT_SKILL_INVOCATION } from './github-copilot-cli/skill-invocation.js';
+import { OMP_SKILL_INVOCATION } from './oh-my-pi/skill-invocation.js';
+import { OPENCODE_SKILL_INVOCATION } from './opencode/skill-invocation.js';
+import { PI_SKILL_INVOCATION } from './pi/skill-invocation.js';
+export const SKILL_INVOCATIONS = {
+    'claude-code': CLAUDE_SKILL_INVOCATION,
+    'codex-cli': CODEX_SKILL_INVOCATION,
+    cursor: CURSOR_SKILL_INVOCATION,
+    'github-copilot-cli': COPILOT_SKILL_INVOCATION,
+    opencode: OPENCODE_SKILL_INVOCATION,
+    pi: PI_SKILL_INVOCATION,
+    'oh-my-pi': OMP_SKILL_INVOCATION,
+    'antigravity-cli': ANTIGRAVITY_SKILL_INVOCATION,
+};
+export function resolveSkillInvocation(harness) {
+    return SKILL_INVOCATIONS[harness];
+}

package/dist/src/infrastructure/runtime/runtime-paths.js

@@ -1,8 +1,9 @@
 import { createHash } from 'node:crypto';
 import { mkdir, writeFile } from 'node:fs/promises';
 import { join, resolve } from 'node:path';
+import { RUNTIME_IGNORE_CONTENT } from '../../core/contracts/context-reading.js';
 import { RUNTIME_STATE_RELATIVE_DIR } from '../storage/runtime-state-files.js';
-export const RUNTIME_GITIGNORE_CONTENT = '*\n';
+export const RUNTIME_GITIGNORE_CONTENT = RUNTIME_IGNORE_CONTENT;
 export const SESSIONS_DIR_NAME = 'sessions';
 export const LEDGER_FILE_EXTENSION = '.jsonl';
 export const SESSIONS_RELATIVE_PREFIX = `${RUNTIME_STATE_RELATIVE_DIR}/${SESSIONS_DIR_NAME}/`;

package/dist/src/infrastructure/skills/frontmatter.d.ts

@@ -0,0 +1,5 @@
+export type Frontmatter = {
+    readonly name: string | null;
+    readonly description: string;
+};
+export declare function parseFrontmatter(text: string): Frontmatter;

package/dist/src/infrastructure/skills/frontmatter.js

@@ -0,0 +1,25 @@
+const DELIMITER = '---';
+const BYTE_ORDER_MARK = '';
+const KEY_LINE = /^(name|description):\s*(.*)$/;
+const BLOCK_SCALAR = /^[>|]/;
+const QUOTED = /^(["'])(.*)\1$/;
+function scalar(raw) {
+    const value = raw.trim();
+    if (BLOCK_SCALAR.test(value))
+        return '';
+    return value.replace(QUOTED, '$2');
+}
+export function parseFrontmatter(text) {
+    const lines = text.replace(BYTE_ORDER_MARK, '').split(/\r?\n/);
+    const fields = { name: '', description: '' };
+    if (lines[0]?.trim() !== DELIMITER)
+        return { name: null, description: '' };
+    for (const line of lines.slice(1)) {
+        if (line.trim() === DELIMITER)
+            break;
+        const match = KEY_LINE.exec(line);
+        if (match?.[1] === 'name' || match?.[1] === 'description')
+            fields[match[1]] = scalar(match[2] ?? '');
+    }
+    return { name: fields.name === '' ? null : fields.name, description: fields.description };
+}

package/dist/src/infrastructure/skills/skill-catalog-reader.d.ts

@@ -0,0 +1,4 @@
+import type { SkillCatalog } from '../../core/contracts/skill-catalog.js';
+export declare const MAX_FRONTMATTER_BYTES = 8192;
+export declare const MAX_SKILL_DIRECTORIES = 500;
+export declare function readSkillFolders(projectRoot: string, folders: readonly string[]): Promise<SkillCatalog>;

package/dist/src/infrastructure/skills/skill-catalog-reader.js

@@ -0,0 +1,78 @@
+import { open, readdir, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { isSkillName } from '../../core/contracts/skill-name.js';
+import { parseFrontmatter } from './frontmatter.js';
+export const MAX_FRONTMATTER_BYTES = 8192;
+export const MAX_SKILL_DIRECTORIES = 500;
+const SKILL_FILE = 'SKILL.md';
+const MISSING_CODES = new Set(['ENOENT', 'ENOTDIR']);
+const CHUNK_SIZE = 32;
+function errorCode(error) {
+    return error instanceof Error && 'code' in error && typeof error.code === 'string' ? error.code : 'unreadable';
+}
+async function readHead(file) {
+    try {
+        const handle = await open(file, 'r');
+        try {
+            const buffer = Buffer.alloc(MAX_FRONTMATTER_BYTES);
+            const { bytesRead } = await handle.read(buffer, 0, MAX_FRONTMATTER_BYTES, 0);
+            return buffer.toString('utf8', 0, bytesRead);
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    catch (error) {
+        if (MISSING_CODES.has(errorCode(error)))
+            return null;
+        throw error;
+    }
+}
+async function readSkill({ folder, directory, entry }) {
+    const path = join(directory, entry);
+    try {
+        if (!(await stat(path)).isDirectory())
+            return { skill: null, warning: null };
+        const head = await readHead(join(path, SKILL_FILE));
+        if (head === null)
+            return { skill: null, warning: null };
+        const { name, description } = parseFrontmatter(head);
+        const resolved = name ?? entry;
+        return { skill: isSkillName(resolved) ? { name: resolved, description, folder } : null, warning: null };
+    }
+    catch (error) {
+        return MISSING_CODES.has(errorCode(error)) ? { skill: null, warning: null } : { skill: null, warning: `${folder}/${entry}: ${errorCode(error)}` };
+    }
+}
+async function readChunked(entries) {
+    const found = [];
+    for (let start = 0; start < entries.length; start += CHUNK_SIZE)
+        found.push(...await Promise.all(entries.slice(start, start + CHUNK_SIZE).map(readSkill)));
+    return found;
+}
+async function listFolder(projectRoot, folder) {
+    const directory = join(projectRoot, folder);
+    try {
+        const names = (await readdir(directory)).sort().slice(0, MAX_SKILL_DIRECTORIES);
+        return { entries: names.map((entry) => ({ folder, directory, entry })), warning: null };
+    }
+    catch (error) {
+        return { entries: [], warning: MISSING_CODES.has(errorCode(error)) ? null : `${folder}: ${errorCode(error)}` };
+    }
+}
+export async function readSkillFolders(projectRoot, folders) {
+    const skills = new Map();
+    const warnings = [];
+    for (const folder of folders) {
+        const listed = await listFolder(projectRoot, folder);
+        if (listed.warning !== null)
+            warnings.push(listed.warning);
+        for (const { skill, warning } of await readChunked(listed.entries)) {
+            if (warning !== null)
+                warnings.push(warning);
+            if (skill !== null && !skills.has(skill.name))
+                skills.set(skill.name, skill);
+        }
+    }
+    return { skills: [...skills.values()], warnings };
+}

package/dist/src/infrastructure/skills/skill-catalog.d.ts

@@ -0,0 +1,2 @@
+import type { SkillCatalogReader } from '../../core/contracts/skill-catalog.js';
+export declare function createSkillCatalogReader(): SkillCatalogReader;

package/dist/src/infrastructure/skills/skill-catalog.js

@@ -0,0 +1,5 @@
+import { resolveSkillFolders } from '../harnesses/skill-folders.js';
+import { readSkillFolders } from './skill-catalog-reader.js';
+export function createSkillCatalogReader() {
+    return (harness, projectRoot) => readSkillFolders(projectRoot, resolveSkillFolders(harness));
+}