@agentxm/client-core 0.4.3 → 0.5.0

package/dist/src/unstable/workspace/read-model/discovery/subagents.js

@@ -0,0 +1,52 @@
+/**
+ * WorkspaceReadModel discovery capability for agent subagent files.
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import { makeAppError } from "../../../app-error/index.js";
+import { AGENTS } from "../../../agents/registry.js";
+const isKnownAgentId = (id) => Object.hasOwn(AGENTS, id);
+const scanKnownAgentSubagentFiles = (agent, projectDir) => Effect.gen(function* () {
+    const subagents = agent.subagents;
+    if (subagents === undefined)
+        return [];
+    const fs = yield* FileSystem.FileSystem;
+    const p = yield* Path.Path;
+    const subagentPath = p.resolve(projectDir, subagents.dir);
+    const exists = yield* fs.exists(subagentPath);
+    if (!exists)
+        return [];
+    if (subagents.isFile === true) {
+        return [{ path: subagents.dir }];
+    }
+    const entries = yield* fs.readDirectory(subagentPath);
+    const files = yield* Effect.filter(entries, (entry) => Effect.gen(function* () {
+        const stat = yield* fs.stat(p.join(subagentPath, entry));
+        return stat.type === "File";
+    }), { concurrency: "unbounded" });
+    return yield* Effect.forEach(files, (file) => Effect.succeed({
+        path: p.join(subagents.dir, file),
+    }), { concurrency: "unbounded" });
+}).pipe(Effect.mapError((error) => makeAppError({
+    code: "AGENT_DETECTION_FAILED",
+    what: `Failed to scan subagent files for ${agent.name}`,
+    cause: error,
+})));
+export const scanAgentSubagentFiles = (agentId, projectDir) => isKnownAgentId(agentId)
+    ? scanKnownAgentSubagentFiles(AGENTS[agentId], projectDir)
+    : Effect.succeed([]);
+export const scanAllSubagentFiles = (projectDir) => Effect.gen(function* () {
+    const agentsWithSubagents = Object.values(AGENTS).filter((agent) => agent.subagents !== undefined);
+    const results = yield* Effect.forEach(agentsWithSubagents, (agent) => Effect.gen(function* () {
+        const files = yield* scanKnownAgentSubagentFiles(agent, projectDir);
+        return {
+            agentId: agent.id,
+            agentName: agent.name,
+            subagentDir: agent.subagents?.dir ?? "",
+            files,
+        };
+    }), { concurrency: "unbounded" });
+    return results.filter((result) => result.files.length > 0);
+});
+//# sourceMappingURL=subagents.js.map

package/dist/src/unstable/workspace/read-model/discovery/subagents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagents.js","sourceRoot":"","sources":["../../../../../../src/unstable/workspace/read-model/discovery/subagents.ts"],"names":[],"mappings":"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"}

package/dist/src/unstable/workspace/read-model/errors.d.ts

@@ -0,0 +1,74 @@
+/** Per-source tagged error families for WorkspaceReadModel source-backed cells. */
+declare const SettingsIoError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "SettingsIoError";
+} & Readonly<A>;
+/** Settings file IO failure (unreadable, permission denied, lower-level error). */
+export declare class SettingsIoError extends SettingsIoError_base<{
+    readonly path: string;
+    readonly cause: unknown;
+}> {
+}
+declare const SettingsParseError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "SettingsParseError";
+} & Readonly<A>;
+/** Settings JSON parse failure; `raw` carries the unparsed text. */
+export declare class SettingsParseError extends SettingsParseError_base<{
+    readonly path: string;
+    readonly raw: string;
+    readonly cause: unknown;
+}> {
+}
+declare const SettingsDecodeError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "SettingsDecodeError";
+} & Readonly<A>;
+/** Settings schema decode failure; `raw` carries the parsed value. */
+export declare class SettingsDecodeError extends SettingsDecodeError_base<{
+    readonly path: string;
+    readonly issues: ReadonlyArray<string>;
+    readonly raw: unknown;
+}> {
+}
+/** Settings-read failure union (IO, parse, decode). */
+export type SettingsReadError = SettingsIoError | SettingsParseError | SettingsDecodeError;
+declare const LockfileIoError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "LockfileIoError";
+} & Readonly<A>;
+/** Lockfile IO failure. */
+export declare class LockfileIoError extends LockfileIoError_base<{
+    readonly path: string;
+    readonly cause: unknown;
+}> {
+}
+declare const LockfileParseError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "LockfileParseError";
+} & Readonly<A>;
+/** Lockfile YAML parse failure; `raw` carries the unparsed text. */
+export declare class LockfileParseError extends LockfileParseError_base<{
+    readonly path: string;
+    readonly raw: string;
+    readonly cause: unknown;
+}> {
+}
+declare const LockfileDecodeError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "LockfileDecodeError";
+} & Readonly<A>;
+/** Lockfile schema decode failure; `raw` carries the parsed value. */
+export declare class LockfileDecodeError extends LockfileDecodeError_base<{
+    readonly path: string;
+    readonly issues: ReadonlyArray<string>;
+    readonly raw: unknown;
+}> {
+}
+/** Lockfile-read failure union (IO, parse, decode). */
+export type LockfileReadError = LockfileIoError | LockfileParseError | LockfileDecodeError;
+declare const WorkspaceRootEscape_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "WorkspaceRootEscape";
+} & Readonly<A>;
+/** Provider-construction error: workspace root escapes the configured allowed root. */
+export declare class WorkspaceRootEscape extends WorkspaceRootEscape_base<{
+    readonly workspaceRoot: string;
+    readonly allowedRoot: string;
+}> {
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/unstable/workspace/read-model/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/workspace/read-model/errors.ts"],"names":[],"mappings":"AAAA,mFAAmF;;;;AAInF,mFAAmF;AACnF,qBAAa,eAAgB,SAAQ,qBAAoC;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;CAAG;;;;AAEL,oEAAoE;AACpE,qBAAa,kBAAmB,SAAQ,wBAAuC;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;CAAG;;;;AAEL,sEAAsE;AACtE,qBAAa,mBAAoB,SAAQ,yBAAwC;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB,CAAC;CAAG;AAEL,uDAAuD;AACvD,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;;;;AAE3F,2BAA2B;AAC3B,qBAAa,eAAgB,SAAQ,qBAAoC;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;CAAG;;;;AAEL,oEAAoE;AACpE,qBAAa,kBAAmB,SAAQ,wBAAuC;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;CAAG;;;;AAEL,sEAAsE;AACtE,qBAAa,mBAAoB,SAAQ,yBAAwC;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB,CAAC;CAAG;AAEL,uDAAuD;AACvD,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;;;;AAE3F,uFAAuF;AACvF,qBAAa,mBAAoB,SAAQ,yBAAwC;IAC/E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC;CAAG"}

package/dist/src/unstable/workspace/read-model/errors.js

@@ -0,0 +1,24 @@
+/** Per-source tagged error families for WorkspaceReadModel source-backed cells. */
+import * as Data from "effect/Data";
+/** Settings file IO failure (unreadable, permission denied, lower-level error). */
+export class SettingsIoError extends Data.TaggedError("SettingsIoError") {
+}
+/** Settings JSON parse failure; `raw` carries the unparsed text. */
+export class SettingsParseError extends Data.TaggedError("SettingsParseError") {
+}
+/** Settings schema decode failure; `raw` carries the parsed value. */
+export class SettingsDecodeError extends Data.TaggedError("SettingsDecodeError") {
+}
+/** Lockfile IO failure. */
+export class LockfileIoError extends Data.TaggedError("LockfileIoError") {
+}
+/** Lockfile YAML parse failure; `raw` carries the unparsed text. */
+export class LockfileParseError extends Data.TaggedError("LockfileParseError") {
+}
+/** Lockfile schema decode failure; `raw` carries the parsed value. */
+export class LockfileDecodeError extends Data.TaggedError("LockfileDecodeError") {
+}
+/** Provider-construction error: workspace root escapes the configured allowed root. */
+export class WorkspaceRootEscape extends Data.TaggedError("WorkspaceRootEscape") {
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/unstable/workspace/read-model/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../../src/unstable/workspace/read-model/errors.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC,mFAAmF;AACnF,MAAM,OAAO,eAAgB,SAAQ,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAGrE;CAAG;AAEL,oEAAoE;AACpE,MAAM,OAAO,kBAAmB,SAAQ,IAAI,CAAC,WAAW,CAAC,oBAAoB,CAI3E;CAAG;AAEL,sEAAsE;AACtE,MAAM,OAAO,mBAAoB,SAAQ,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAI7E;CAAG;AAKL,2BAA2B;AAC3B,MAAM,OAAO,eAAgB,SAAQ,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAGrE;CAAG;AAEL,oEAAoE;AACpE,MAAM,OAAO,kBAAmB,SAAQ,IAAI,CAAC,WAAW,CAAC,oBAAoB,CAI3E;CAAG;AAEL,sEAAsE;AACtE,MAAM,OAAO,mBAAoB,SAAQ,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAI7E;CAAG;AAKL,uFAAuF;AACvF,MAAM,OAAO,mBAAoB,SAAQ,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAG7E;CAAG"}

package/dist/src/unstable/workspace/read-model/extensions/actual-helpers.d.ts

@@ -0,0 +1,4 @@
+export declare const filterMapOccurrences: <TOccurrence extends {
+    readonly type: string;
+}, A>(occurrences: ReadonlyArray<TOccurrence>, type: TOccurrence["type"], map: (occurrence: TOccurrence) => A) => ReadonlyArray<A>;
+//# sourceMappingURL=actual-helpers.d.ts.map

package/dist/src/unstable/workspace/read-model/extensions/actual-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actual-helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/workspace/read-model/extensions/actual-helpers.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,oBAAoB,GAAI,WAAW,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,EACnF,aAAa,aAAa,CAAC,WAAW,CAAC,EACvC,MAAM,WAAW,CAAC,MAAM,CAAC,EACzB,KAAK,CAAC,UAAU,EAAE,WAAW,KAAK,CAAC,KAClC,aAAa,CAAC,CAAC,CAKf,CAAC"}

package/dist/src/unstable/workspace/read-model/extensions/actual-helpers.js

@@ -0,0 +1,4 @@
+import * as Array from "effect/Array";
+import * as Option from "effect/Option";
+export const filterMapOccurrences = (occurrences, type, map) => Array.getSomes(occurrences.map((occurrence) => occurrence.type === type ? Option.some(map(occurrence)) : Option.none()));
+//# sourceMappingURL=actual-helpers.js.map

package/dist/src/unstable/workspace/read-model/extensions/actual-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actual-helpers.js","sourceRoot":"","sources":["../../../../../../src/unstable/workspace/read-model/extensions/actual-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,WAAuC,EACvC,IAAyB,EACzB,GAAmC,EACjB,EAAE,CACpB,KAAK,CAAC,QAAQ,CACZ,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAC7B,UAAU,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CACxE,CACF,CAAC"}

package/dist/src/unstable/workspace/read-model/extensions/command.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Command subject module: declared/resolved/actual payloads, scanner
+ * composition (canonical-extensions + agent-dir × command-rendering agents),
+ * and projections via the shared helper.
+ *
+ * Mirrors `extensions/skill.ts` for command subjects. Activation comes from
+ * the declared `enabled` flag.
+ */
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import type { AgentId } from "../../../agents/types.js";
+import { type ExtensionName } from "../../../extensions/common.js";
+import type { CommandLockEntry, Lockfile } from "../../../lockfile/schema.js";
+import type { CommandEntry, Settings } from "../../../settings/schema.js";
+import type { Diagnostics } from "../diagnostics.js";
+import type { LockfileReadError, SettingsReadError } from "../errors.js";
+import type { AgentDirOccurrence, CanonicalExtensionOccurrence } from "../scanners/types.js";
+import type { ActivationState, ExtensionKey, InstallationOrigin, InstalledPackRef, Scope } from "../types.js";
+export type CommandDetectionOrigin = {
+    readonly _tag: "canonical-axm-command";
+} | {
+    readonly _tag: "external-axm-command";
+} | {
+    readonly _tag: "agent-command-dir";
+    readonly agentId: AgentId;
+};
+export interface DeclaredCommand {
+    readonly name: ExtensionName;
+    readonly entry: CommandEntry;
+}
+export type DeclaredCommands = ReadonlyArray<DeclaredCommand>;
+export interface ResolvedCommand {
+    readonly name: ExtensionName;
+    readonly lockEntry: CommandLockEntry;
+}
+export type ResolvedCommands = ReadonlyArray<ResolvedCommand>;
+export interface ActualCommand {
+    readonly key: ExtensionKey<"command">;
+    readonly origin: CommandDetectionOrigin;
+    readonly contentRoot: string;
+    readonly sourcePath: string | null;
+    readonly packageRoot: string | null;
+}
+export type ActualCommands = ReadonlyArray<ActualCommand>;
+export interface CommandPackMember {
+    readonly name: ExtensionName;
+    readonly providingPack: InstalledPackRef;
+}
+export interface InstalledCommand {
+    readonly key: ExtensionKey<"command">;
+    readonly installationOrigin: InstallationOrigin<DeclaredCommand, CommandPackMember>;
+    readonly activation: ActivationState;
+    readonly resolved: Option.Option<ResolvedCommand>;
+    readonly actual: ReadonlyArray<ActualCommand>;
+    readonly providingPacks: ReadonlyArray<InstalledPackRef>;
+}
+export interface UnmanagedCommand {
+    readonly key: ExtensionKey<"command">;
+    readonly actual: ActualCommand;
+}
+export type IgnoredCommandCandidate = {
+    readonly key: ExtensionKey<"command">;
+    readonly reason: "declared-ignored";
+    readonly declared: DeclaredCommand;
+} | {
+    readonly key: ExtensionKey<"command">;
+    readonly reason: "pack-member-ignored";
+    readonly member: CommandPackMember;
+    readonly pack: InstalledPackRef;
+} | {
+    readonly key: ExtensionKey<"command">;
+    readonly reason: "actual-ignored";
+    readonly actual: ActualCommand;
+};
+export interface CommandScopedLoaders {
+    readonly settings: Effect.Effect<Option.Option<Settings>, SettingsReadError>;
+    readonly lockfile: Effect.Effect<Option.Option<Lockfile>, LockfileReadError>;
+}
+export interface CommandScanners {
+    readonly canonical: Effect.Effect<ReadonlyArray<CanonicalExtensionOccurrence>>;
+    readonly agentDir: Effect.Effect<ReadonlyArray<AgentDirOccurrence>>;
+}
+export interface InstalledPackForCommands {
+    readonly ref: InstalledPackRef;
+    readonly commands: ReadonlyArray<CommandPackMember>;
+}
+export interface CommandExtensionsApiDeps {
+    readonly scope: Scope;
+    readonly loaders: CommandScopedLoaders;
+    readonly scanners: CommandScanners;
+    readonly installedPacks: Effect.Effect<ReadonlyArray<InstalledPackForCommands>>;
+    readonly ignoredNames: ReadonlySet<string>;
+    readonly diagnostics: Diagnostics;
+}
+export interface CommandExtensionsApi {
+    readonly declared: Effect.Effect<Option.Option<DeclaredCommands>, SettingsReadError>;
+    readonly resolved: Effect.Effect<Option.Option<ResolvedCommands>, LockfileReadError>;
+    readonly actual: Effect.Effect<ActualCommands>;
+    readonly installed: Effect.Effect<ReadonlyArray<InstalledCommand>>;
+    readonly byName: (name: string) => Effect.Effect<Option.Option<InstalledCommand>>;
+    readonly declaredByName: (name: string) => Effect.Effect<Option.Option<DeclaredCommand>, SettingsReadError>;
+    readonly active: Effect.Effect<ReadonlyArray<InstalledCommand>>;
+    readonly unmanaged: Effect.Effect<ReadonlyArray<UnmanagedCommand>>;
+    readonly ignored: Effect.Effect<ReadonlyArray<IgnoredCommandCandidate>>;
+}
+/**
+ * Build the command subject API. Returns an `Effect` because the projection
+ * cell is wrapped in `Effect.cached` so the four derived cells share one
+ * in-flight execution per scope, mirroring `state.ts`.
+ */
+export declare const makeCommandExtensionsApi: (deps: CommandExtensionsApiDeps) => Effect.Effect<CommandExtensionsApi>;
+//# sourceMappingURL=command.d.ts.map

package/dist/src/unstable/workspace/read-model/extensions/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/workspace/read-model/extensions/command.ts"],"names":[],"mappings":"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"}

package/dist/src/unstable/workspace/read-model/extensions/command.js

@@ -0,0 +1,136 @@
+/**
+ * Command subject module: declared/resolved/actual payloads, scanner
+ * composition (canonical-extensions + agent-dir × command-rendering agents),
+ * and projections via the shared helper.
+ *
+ * Mirrors `extensions/skill.ts` for command subjects. Activation comes from
+ * the declared `enabled` flag.
+ */
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { decodeExtensionNameSync } from "../../../extensions/common.js";
+import { filterMapOccurrences } from "./actual-helpers.js";
+import { canonicalAxmPackageRoot } from "./package-root.js";
+import { makeProjectedSubjectCells, projectInstalledExtensions, } from "./projection.js";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const declaredFromSettings = (settings) => {
+    if (settings.commands === undefined)
+        return [];
+    return Object.entries(settings.commands).map(([name, entry]) => ({
+        name: decodeExtensionNameSync(name),
+        entry,
+    }));
+};
+const resolvedFromLockfile = (lockfile) => {
+    if (lockfile.commands === undefined)
+        return [];
+    return Object.entries(lockfile.commands).map(([name, lockEntry]) => ({
+        name: decodeExtensionNameSync(name),
+        lockEntry,
+    }));
+};
+const canonicalToActual = (occ, scope) => {
+    const isExternal = occ.origin === "external-axm";
+    const packageRoot = canonicalAxmPackageRoot(occ);
+    return {
+        key: { scope, type: "command", name: occ.name },
+        origin: isExternal ? { _tag: "external-axm-command" } : { _tag: "canonical-axm-command" },
+        contentRoot: occ.contentLocation,
+        sourcePath: Option.getOrNull(occ.subjectFile),
+        packageRoot,
+    };
+};
+const agentDirToActual = (occ, scope) => ({
+    key: { scope, type: "command", name: occ.name },
+    origin: { _tag: "agent-command-dir", agentId: occ.agentId },
+    contentRoot: occ.contentLocation,
+    sourcePath: Option.getOrNull(occ.subjectFile),
+    packageRoot: null,
+});
+const SUBJECT_KEY = "command";
+const orphanResolvedWarning = (name) => ({
+    source: "lockfile",
+    message: `command: lockfile entry "${name}" has no matching declared or pack-member home`,
+    code: "orphan-resolved",
+});
+const commandPolicy = (scope) => ({
+    declaredEntries: (d) => d,
+    declaredName: (e) => e.name,
+    declaredActivation: (e) => (e.entry.enabled ? "enabled" : "disabled"),
+    resolvedEntries: (r) => r,
+    resolvedName: (e) => e.name,
+    actualEntries: (a) => a,
+    actualName: (e) => e.key.name,
+    packMemberName: (m) => m.name,
+    isIgnoredName: (name, ignored) => ignored.has(name),
+    packMemberActivation: () => "enabled",
+    attachActualToInstalled: (name, actual) => actual.filter((a) => a.key.name === name),
+    notClaimedBySubjectPolicy: () => true,
+    buildInstalledRow: (input) => ({
+        key: { scope, type: "command", name: input.name },
+        installationOrigin: input.installationOrigin,
+        activation: input.activation,
+        resolved: input.resolved,
+        actual: input.actual,
+        providingPacks: input.providingPacks,
+    }),
+    buildUnmanagedRow: (entry) => ({
+        key: { scope, type: "command", name: entry.key.name },
+        actual: entry,
+    }),
+    buildDeclaredIgnoredRow: (input) => ({
+        key: { scope, type: "command", name: input.name },
+        reason: "declared-ignored",
+        declared: input.declared,
+    }),
+    buildPackMemberIgnoredRow: (input) => ({
+        key: { scope, type: "command", name: input.name },
+        reason: "pack-member-ignored",
+        member: input.member,
+        pack: input.pack,
+    }),
+    buildActualIgnoredRow: (input) => ({
+        key: { scope, type: "command", name: input.name },
+        reason: "actual-ignored",
+        actual: input.actual,
+    }),
+    resolvedOrphanWarning: orphanResolvedWarning,
+});
+/**
+ * Build the command subject API. Returns an `Effect` because the projection
+ * cell is wrapped in `Effect.cached` so the four derived cells share one
+ * in-flight execution per scope, mirroring `state.ts`.
+ */
+export const makeCommandExtensionsApi = (deps) => Effect.gen(function* () {
+    const { scope, loaders, scanners, installedPacks, ignoredNames, diagnostics } = deps;
+    const declared = loaders.settings.pipe(Effect.map((opt) => Option.map(opt, declaredFromSettings)));
+    const resolved = loaders.lockfile.pipe(Effect.map((opt) => Option.map(opt, resolvedFromLockfile)));
+    const actual = Effect.gen(function* () {
+        const canonical = yield* scanners.canonical;
+        const agentDir = yield* scanners.agentDir;
+        const fromCanonical = filterMapOccurrences(canonical, "command", (occ) => canonicalToActual(occ, scope));
+        const fromAgentDir = filterMapOccurrences(agentDir, "command", (occ) => agentDirToActual(occ, scope));
+        return [...fromCanonical, ...fromAgentDir];
+    });
+    const project = yield* Effect.cached(projectInstalledExtensions({
+        subjectKey: SUBJECT_KEY,
+        declared,
+        resolved,
+        actual,
+        installedPacks: installedPacks.pipe(Effect.map((packs) => packs.map((p) => ({ ref: p.ref, members: p.commands })))),
+        packMembers: (pack) => pack.members,
+        packRef: (pack) => pack.ref,
+        ignoredNames,
+        policy: commandPolicy(scope),
+        diagnostics,
+    }));
+    return makeProjectedSubjectCells({
+        declared,
+        resolved,
+        actual,
+        project,
+    });
+});
+//# sourceMappingURL=command.js.map

package/dist/src/unstable/workspace/read-model/extensions/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../../../../src/unstable/workspace/read-model/extensions/command.ts"],"names":[],"mappings":"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"}

package/dist/src/unstable/workspace/read-model/extensions/file.d.ts

@@ -0,0 +1,93 @@
+/**
+ * File subject module: declared/resolved/actual payloads, scanner composition,
+ * and projections via the shared helper.
+ *
+ * Files have no `settings.json` entry shape and no `axm-lock.yaml` entry
+ * shape in v1; `declared` and `resolved` cells therefore return
+ * `Option.none()` permanently. Actual occurrences come exclusively from the
+ * canonical-extensions scanner (`type === "file"`); no agent registers a
+ * file rendering directory.
+ *
+ * The projection helper still owns ignored/unmanaged behavior: a canonical
+ * file occurrence whose name matches an ignored pattern produces an ignored
+ * row; otherwise it surfaces in `unmanaged`.
+ */
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import type { ExtensionName } from "../../../extensions/common.js";
+import type { Diagnostics } from "../diagnostics.js";
+import type { CanonicalExtensionOccurrence } from "../scanners/types.js";
+import type { ActivationState, ExtensionKey, InstallationOrigin, InstalledPackRef, Scope } from "../types.js";
+export type FileDetectionOrigin = {
+    readonly _tag: "canonical-axm-file";
+} | {
+    readonly _tag: "external-axm-file";
+};
+/**
+ * v1 has no settings entry for files; the declared payload type is `never[]`
+ * effectively, but the helper still wants a typed array shape.
+ */
+export type DeclaredFile = never;
+export type DeclaredFiles = ReadonlyArray<DeclaredFile>;
+export type ResolvedFile = never;
+export type ResolvedFiles = ReadonlyArray<ResolvedFile>;
+export interface ActualFile {
+    readonly key: ExtensionKey<"file">;
+    readonly origin: FileDetectionOrigin;
+    readonly contentRoot: string;
+    readonly packageRoot: string | null;
+}
+export type ActualFiles = ReadonlyArray<ActualFile>;
+export interface FilePackMember {
+    readonly name: ExtensionName;
+    readonly providingPack: InstalledPackRef;
+}
+export interface InstalledFile {
+    readonly key: ExtensionKey<"file">;
+    readonly installationOrigin: InstallationOrigin<DeclaredFile, FilePackMember>;
+    readonly activation: ActivationState;
+    readonly resolved: Option.Option<ResolvedFile>;
+    readonly actual: ReadonlyArray<ActualFile>;
+    readonly providingPacks: ReadonlyArray<InstalledPackRef>;
+}
+export interface UnmanagedFile {
+    readonly key: ExtensionKey<"file">;
+    readonly actual: ActualFile;
+}
+export type IgnoredFileCandidate = {
+    readonly key: ExtensionKey<"file">;
+    readonly reason: "actual-ignored";
+    readonly actual: ActualFile;
+};
+export interface FileScanners {
+    readonly canonical: Effect.Effect<ReadonlyArray<CanonicalExtensionOccurrence>>;
+}
+export interface InstalledPackForFiles {
+    readonly ref: InstalledPackRef;
+    readonly files: ReadonlyArray<FilePackMember>;
+}
+export interface FileExtensionsApiDeps {
+    readonly scope: Scope;
+    readonly scanners: FileScanners;
+    readonly installedPacks: Effect.Effect<ReadonlyArray<InstalledPackForFiles>>;
+    readonly ignoredNames: ReadonlySet<string>;
+    readonly diagnostics: Diagnostics;
+}
+export interface FileExtensionsApi {
+    readonly declared: Effect.Effect<Option.Option<DeclaredFiles>>;
+    readonly resolved: Effect.Effect<Option.Option<ResolvedFiles>>;
+    readonly actual: Effect.Effect<ActualFiles>;
+    readonly installed: Effect.Effect<ReadonlyArray<InstalledFile>>;
+    readonly byName: (name: string) => Effect.Effect<Option.Option<InstalledFile>>;
+    readonly declaredByName: (name: string) => Effect.Effect<Option.Option<DeclaredFile>>;
+    readonly active: Effect.Effect<ReadonlyArray<InstalledFile>>;
+    readonly unmanaged: Effect.Effect<ReadonlyArray<UnmanagedFile>>;
+    readonly ignored: Effect.Effect<ReadonlyArray<IgnoredFileCandidate>>;
+}
+/**
+ * Build the file subject API. Returns an `Effect` because the projection
+ * cell is wrapped in `Effect.cached` so the four derived cells share one
+ * in-flight execution per scope, mirroring `state.ts`.
+ */
+export declare const makeFileExtensionsApi: (deps: FileExtensionsApiDeps) => Effect.Effect<FileExtensionsApi>;
+//# sourceMappingURL=file.d.ts.map

package/dist/src/unstable/workspace/read-model/extensions/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/workspace/read-model/extensions/file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAW,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,EACN,MAAM,aAAa,CAAC;AAarB,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAA;CAAE,GACvC;IAAE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAM3C;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC;AACjC,MAAM,MAAM,aAAa,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;AAExD,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC;AACjC,MAAM,MAAM,aAAa,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AACD,MAAM,MAAM,WAAW,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;AAEpD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;CAC1C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IACnC,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAC9E,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAC3C,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B,CAAC;AAqBF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,4BAA4B,CAAC,CAAC,CAAC;CAChF;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC7E,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;IAC/D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;IAChE,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;IAC/E,QAAQ,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;IACtF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;IAC7D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;IAChE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC,CAAC;CACtE;AAmED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,MAAM,qBAAqB,KAC1B,MAAM,CAAC,MAAM,CAAC,iBAAiB,CA+C9B,CAAC"}