@first-tree-ai/context-tree 0.1.9-alpha.202609020917 → 0.1.9

package/README.md

@@ -44,12 +44,14 @@ new agent, or scope it to one project:
 context-tree install                       # every agent you have
 context-tree install --host codex          # one agent
 context-tree install --project .           # ./.claude/skills and ./.codex/skills
+context-tree uninstall                     # remove context-tree-* skills
 ```
 
-Installing only ever writes `context-tree-*` skill directories, never touches
-skills it does not own, and never creates a configuration directory for an agent
-that is not present. Adding support for another agent is one entry in the host
-table in `src/core/install.ts`.
+Install and uninstall own exactly the `context-tree-*` skill directories.
+Install never touches skills it does not own or creates a configuration directory
+for an agent that is not present; uninstall removes every owned-prefix directory
+and nothing else. Adding support for another agent is one entry in the host table
+in `src/core/install.ts`.
 
 Once a project is connected, `create` and `connect` record the tree in the
 project's own `AGENTS.md`, so any agent that reads instruction files knows the
@@ -181,13 +183,14 @@ commit or discard them), `INVALID_TREE` (structure fails `verify`),
 The public command inventory is:
 
 ```text
-install  create  connect  list  resolve  sync  prepare-write
+install  uninstall  create  connect  list  resolve  sync  prepare-write
 finish-write  publish  read  verify
 ```
 
 Setup, create, connect, read, write, and publish ship as six skills; setup
 orchestrates the five concrete workflows. `install` is the distribution
-entry point, run for you by `npm install`. `resolve`, `sync`, `prepare-write`,
+entry point, run for you by `npm install`; `uninstall` is its supported reverse.
+`resolve`, `sync`, `prepare-write`,
 `finish-write`, and `verify` are plumbing or diagnostic commands rather than
 separate user intentions; `list` backs setup's connect-target discovery.
 
@@ -197,7 +200,7 @@ separate user intentions; `list` backs setup's connect-target discovery.
 human-readable text by default and accept `--json` to emit their strict schema
 version `1` payload for scripts and agents; in text mode a failure prints a
 sanitized message to stderr with a non-zero exit code. The six skills always
-pass `--json`. `sync`, `prepare-write`, `finish-write`, and `install` are
+pass `--json`. `sync`, `prepare-write`, `finish-write`, `install`, and `uninstall` are
 low-level plumbing and always emit that JSON (with the error envelope on stdout).
 `--help` and `--version` are always plain text.
 

package/dist/cli/index.mjs

@@ -7368,6 +7368,12 @@ object({
 	skipped: array(skillInstallSkipSchema),
 	version: string$2().trim().min(1)
 }).strict();
+object({
+	removed: array(skillInstallationSchema),
+	schemaVersion: literal(1),
+	skipped: array(skillInstallSkipSchema),
+	version: string$2().trim().min(1)
+}).strict();
 const contextTreeReadCommonFields = {
 	contentClass: contextContentClassSchema,
 	kind: _enum(["directory", "file"]),
@@ -25986,6 +25992,18 @@ function hostDestination(host, root, isProjectInstall) {
 	}
 	return { destination: ensureRealDirectory(root, [configDirectory, SKILLS_DIRECTORY]) };
 }
+/** Resolve one host's existing skills root without creating or following anything. */
+function hostSkillsRoot(host, root) {
+	const hostRoot = join(root, HOST_CONFIG_DIRECTORY[host]);
+	const hostEntry = lstatSync(hostRoot, { throwIfNoEntry: false });
+	if (hostEntry === void 0) return { reason: `${hostRoot} does not exist; nothing to remove.` };
+	if (hostEntry.isSymbolicLink() || !hostEntry.isDirectory()) return { reason: `${hostRoot} is not a real directory.` };
+	const skillsRoot = join(hostRoot, SKILLS_DIRECTORY);
+	const skillsEntry = lstatSync(skillsRoot, { throwIfNoEntry: false });
+	if (skillsEntry === void 0) return { reason: `${skillsRoot} does not exist; nothing to remove.` };
+	if (skillsEntry.isSymbolicLink() || !skillsEntry.isDirectory()) return { reason: `${skillsRoot} is not a real directory.` };
+	return { destination: skillsRoot };
+}
 /**
 * Copy the packaged skills into each requested host's skill directory.
 *
@@ -26032,6 +26050,53 @@ function installSkills(options = {}) {
 		version: readPackageVersion()
 	};
 }
+/** Remove every skill owned by the `context-tree-` prefix from each requested host. */
+function uninstallSkills(options = {}) {
+	const hosts = options.hosts === void 0 || options.hosts.length === 0 ? SKILL_HOSTS : options.hosts;
+	const root = options.projectPath === void 0 ? realHome() : resolve(options.projectPath);
+	const removed = [];
+	const skipped = [];
+	for (const host of hosts) {
+		const resolved = hostSkillsRoot(host, root);
+		if ("reason" in resolved) {
+			skipped.push({
+				host,
+				reason: resolved.reason
+			});
+			continue;
+		}
+		const skills = [];
+		for (const entry of readdirSync(resolved.destination, { withFileTypes: true })) {
+			if (!entry.name.startsWith(OWNED_SKILL_PREFIX)) continue;
+			const target = join(resolved.destination, entry.name);
+			const targetEntry = lstatSync(target, { throwIfNoEntry: false });
+			if (targetEntry === void 0) continue;
+			if (targetEntry.isSymbolicLink() || !targetEntry.isDirectory()) {
+				skipped.push({
+					host,
+					reason: `${target} is not a real directory.`
+				});
+				continue;
+			}
+			rmSync(target, {
+				force: true,
+				recursive: true
+			});
+			skills.push(entry.name);
+		}
+		removed.push({
+			host,
+			path: resolved.destination,
+			skills: skills.sort()
+		});
+	}
+	return {
+		removed,
+		schemaVersion: 1,
+		skipped,
+		version: readPackageVersion()
+	};
+}
 //#endregion
 //#region src/core/publish.ts
 function authenticatedAccount(runner) {
@@ -26626,6 +26691,12 @@ function createContextTreeCli(io = defaultIo) {
 		if (options.project !== void 0) request.projectPath = resolve(io.cwd(), options.project);
 		line(io, JSON.stringify(installSkills(request)));
 	});
+	program.command("uninstall").description("Remove packaged Context Tree skills from each agent's skill directory.").option("--host <host>", "restrict to one host: claude, codex, or all", "all").option("--project <path>", "remove below this project root instead of the home directory").action((options) => {
+		const request = {};
+		if (options.host !== "all") request.hosts = [skillHostSchema.parse(options.host)];
+		if (options.project !== void 0) request.projectPath = resolve(io.cwd(), options.project);
+		line(io, JSON.stringify(uninstallSkills(request)));
+	});
 	return program;
 }
 async function runContextTreeCli(argv = process.argv, io = defaultIo) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@first-tree-ai/context-tree",
-  "version": "0.1.9-alpha.202609020917",
+  "version": "0.1.9",
   "description": "Durable, structured project context for coding agents: a CLI plus framework-neutral skills.",
   "type": "module",
   "license": "Apache-2.0",