facult 2.17.2 → 2.17.4

package/docs/codex-plugin.md

@@ -40,7 +40,20 @@ Use the narrow setup command for normal installs:
 fclt setup codex-plugin
 ```
 
-That updates only the local `fclt` plugin payload under `~/plugins/fclt`, merges the `hack-local` marketplace entry at `~/.agents/plugins/marketplace.json`, and runs `codex plugin add fclt@hack-local --json` when the `codex` command is available. It does not enter managed mode, adopt Codex state, render `~/.codex/AGENTS.md`, or touch existing Codex skills/rules/config.
+That updates only the local `fclt` plugin payload under `~/plugins/fclt`
+and merges an entry into `~/.agents/plugins/marketplace.json`. The default
+marketplace name is `hack-local`; if the marketplace file already has a
+non-empty `name`, fclt preserves it and installs from that name. The generated
+entry uses Codex schema-valid policy values, including
+`installation: "AVAILABLE"` and `authentication: "ON_INSTALL"`.
+
+When the `codex` command is available, setup runs
+`codex plugin add fclt@<marketplace> --json`. Codex installs the plugin cache
+under `~/.codex/plugins/cache/<marketplace>/fclt/` using its own version
+directory.
+
+It does not enter managed mode, adopt Codex state, render
+`~/.codex/AGENTS.md`, or touch existing Codex skills/rules/config.
 
 Useful flags:
 

package/docs/reference.md

@@ -74,7 +74,11 @@ fclt managed
 fclt unmanage <tool>
 ```
 
-`setup codex-plugin` is the narrow path for exposing the bundled fclt Codex plugin without entering managed mode. Managed mode writes rendered output into tool homes. Read [Managed mode](./managed-mode.md) before using it on an existing setup.
+`setup codex-plugin` is the narrow path for exposing the bundled fclt Codex
+plugin without entering managed mode. It writes only `~/plugins/fclt`, the
+local marketplace entry, and the Codex plugin install/cache when Codex is
+available. Managed mode writes rendered output into tool homes. Read
+[Managed mode](./managed-mode.md) before using it on an existing setup.
 
 ## Writeback and evolution
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "facult",
-  "version": "2.17.2",
+  "version": "2.17.4",
   "description": "Manage canonical AI capabilities, sync surfaces, and evolution state.",
   "type": "module",
   "license": "MIT",

package/src/ai.ts

@@ -599,6 +599,7 @@ async function resolveAssetSelection(args: {
   homeDir: string;
   rootDir: string;
   asset: string;
+  repairGraph?: boolean;
 }): Promise<{
   assetRef?: string;
   assetId?: string;
@@ -607,7 +608,7 @@ async function resolveAssetSelection(args: {
   await ensureAiGraphPath({
     homeDir: args.homeDir,
     rootDir: args.rootDir,
-    repair: true,
+    repair: args.repairGraph,
   });
   const graph = await loadGraph({
     homeDir: args.homeDir,
@@ -987,7 +988,11 @@ export async function proposeEvolution(args: {
     : null;
 
   const candidates = writebacks.filter((entry) => {
-    if (entry.status === "dismissed" || entry.status === "superseded") {
+    if (
+      entry.status === "dismissed" ||
+      entry.status === "resolved" ||
+      entry.status === "superseded"
+    ) {
       return false;
     }
     if (entry.evidence.length === 0) {
@@ -1123,11 +1128,13 @@ export async function assessEvolution(args: {
         homeDir,
         rootDir: args.rootDir,
         asset: args.asset,
+        repairGraph: false,
       })
     : null;
   const target = filterAsset?.assetRef ?? args.asset;
   const writebacks = (await listWritebacks({ homeDir, rootDir: args.rootDir }))
     .filter((entry) => entry.status !== "dismissed")
+    .filter((entry) => entry.status !== "resolved")
     .filter((entry) => entry.status !== "superseded")
     .filter((entry) => entry.evidence.length > 0)
     .filter((entry) => {