teamcast 1.0.1 → 1.0.3

package/README.md

@@ -1,11 +1,17 @@
 # TeamCast
 
+[![CI](https://github.com/Katoshy/teamcast/actions/workflows/ci.yml/badge.svg)](https://github.com/Katoshy/teamcast/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/teamcast)](https://www.npmjs.com/package/teamcast)
+[![License](https://img.shields.io/github/license/Katoshy/teamcast)](https://github.com/Katoshy/teamcast/blob/main/LICENSE)
+
 CLI to design, generate, and validate multi-target agent teams for Claude Code and Codex from a single manifest.
 
 Define your agent team in one `teamcast.yaml` file. TeamCast validates the manifest, generates `.claude/` and/or `.codex/` config files, and keeps generated output in sync with the source config.
 
 ## Install
 
+Requires Node.js 24 or newer.
+
 ```bash
 npm install -g teamcast
 ```
@@ -16,6 +22,14 @@ Or run without installing:
 npx teamcast <command>
 ```
 
+## Community
+
+- Contribution guide: [CONTRIBUTING.md](./CONTRIBUTING.md)
+- Code of conduct: [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md)
+- Security policy: [SECURITY.md](./SECURITY.md)
+- Bug reports and feature requests: use the GitHub issue templates
+- Pull requests: use the repository PR template and run `npm test` plus `npm run build` before opening one
+
 ## Quick Start
 
 ```bash
@@ -43,6 +57,7 @@ After `generate`, your project will have files for the selected target(s):
 - Codex target:
   - `.codex/config.toml` - workspace-level Codex config
   - `.codex/agents/<name>.toml` - one TOML config per agent
+  - `.agents/skills/<skill>/SKILL.md` - one stub file per unique skill
   - `AGENTS.md` - team-level instructions for Codex agents
 
 Use `teamcast init --target claude|codex|both` to choose which outputs are generated up front.
@@ -273,7 +288,7 @@ Use `--yes` to skip confirmation.
 
 ### `create skill <name>`
 
-`teamcast create skill <name>` registers a new skill name on one agent, writes `teamcast.yaml`, and generates `.claude/skills/<name>/SKILL.md`.
+`teamcast create skill <name>` registers a new skill name on one agent, writes `teamcast.yaml`, and generates a target-specific stub: `.claude/skills/<name>/SKILL.md` for Claude or `.agents/skills/<name>/SKILL.md` for Codex.
 
 Rules and prompts:
 
@@ -310,7 +325,7 @@ teamcast generate --dry-run
 Behavior:
 
 - `generate` overwrites generated agent/docs/settings files
-- skill stub files under `.claude/skills/` are created only if missing
+- skill stub files under `.claude/skills/` and `.agents/skills/` are created only if missing
 - `--dry-run` shows what would be generated without writing anything
 
 ### `diff`
@@ -429,6 +444,7 @@ It targets:
 
 - `.claude/agents`
 - `.claude/skills`
+- generated Codex skill files under `.agents/skills/`
 - `.claude/settings.json`
 - `.claude/settings.local.json`
 - `CLAUDE.md`
@@ -467,9 +483,9 @@ Everything is defined in `teamcast.yaml` at the root of your project.
 
 For Claude targets, TeamCast renders `.claude/agents/<name>.md` and `CLAUDE.md` from `claude.agents.<name>`.
 
-For Codex targets, TeamCast renders `.codex/agents/<name>.toml` plus `.codex/config.toml` from `codex.agents.<name>`.
+For Codex targets, TeamCast renders `.codex/agents/<name>.toml` plus `.codex/config.toml` from `codex.agents.<name>`, and writes Codex skill docs to `.agents/skills/<skill>/`.
 
-`.codex/config.toml` is the workspace-level agent index. Concrete agent runtime config lives in `.codex/agents/<name>.toml`.
+`.codex/config.toml` is the workspace-level agent index. Concrete agent runtime config lives in `.codex/agents/<name>.toml`. Codex skill discovery uses `.agents/skills/`, not `.codex/`.
 
 Native Claude Code fields are rendered into frontmatter:
 
@@ -642,6 +658,7 @@ claude:
 | `claude.tools`            | string[]                                                         | Native Claude Code tool allow-list                                                             |
 | `claude.disallowed_tools` | string[]                                                         | Native Claude Code tool deny-list                                                              |
 | `claude.skills`           | string[]                                                         | Skill names. Each unique skill generates `.claude/skills/<skill>/SKILL.md`                     |
+| `codex.skills`            | string[]                                                         | Skill names. Each unique skill generates `.agents/skills/<skill>/SKILL.md`                     |
 | `claude.max_turns`        | number                                                           | Maximum agentic turns                                                                          |
 | `claude.mcp_servers`      | object[]                                                         | MCP server definitions                                                                         |
 | `claude.permission_mode`  | `default \| acceptEdits \| bypassPermissions \| plan \| dontAsk` | Claude Code permission mode                                                                    |

package/dist/application/build-generated-files.js

@@ -7,11 +7,13 @@ export function buildGeneratedOutputs(team, targetName, options) {
     const renderer = target.renderer;
     const files = renderer.render(spec);
     if (!options.dryRun) {
-        const editable = files.filter((file) => isUserEditableGeneratedFile(file.path));
-        const generated = files.filter((file) => !isUserEditableGeneratedFile(file.path));
+        const editable = [];
+        const generated = [];
+        for (const file of files) {
+            (isUserEditableGeneratedFile(file.path) ? editable : generated).push(file);
+        }
         writeFiles(generated, options.cwd);
         writeFiles(editable, options.cwd, { skipExisting: true });
     }
     return files;
 }
-//# sourceMappingURL=build-generated-files.js.map

package/dist/application/team.js

@@ -365,4 +365,3 @@ export function updateAgentBasics(agent, options) {
         },
     };
 }
-//# sourceMappingURL=team.js.map

package/dist/application/validate-team.js

@@ -46,4 +46,3 @@ export function teamHasBlockingIssues(summary) {
 export function printManifestValidation(summary) {
     printManifestValidationSummary(summary);
 }
-//# sourceMappingURL=validate-team.js.map

package/dist/cli/diff.js

@@ -51,4 +51,3 @@ export function runDiffCommand() {
     console.log('');
 }
 export { registerDiffCommand } from './registrars/diff.js';
-//# sourceMappingURL=diff.js.map

package/dist/cli/errors.js

@@ -12,4 +12,3 @@ export function abortCli(exitCode = 1) {
 export function isCLIAbortError(error) {
     return error instanceof CLIAbortError;
 }
-//# sourceMappingURL=errors.js.map

package/dist/cli/explain.js

@@ -43,4 +43,3 @@ export function runExplainCommand() {
     }
 }
 export { registerExplainCommand } from './registrars/explain.js';
-//# sourceMappingURL=explain.js.map

package/dist/cli/generate.js

@@ -61,4 +61,3 @@ export async function runGenerateCommand(options) {
     printManifestValidation(validation);
 }
 export { registerGenerateCommand } from './registrars/generate.js';
-//# sourceMappingURL=generate.js.map

package/dist/cli/import.js

@@ -107,4 +107,3 @@ export async function runImportCommand(options) {
     ]);
 }
 export { registerImportCommand } from './registrars/import.js';
-//# sourceMappingURL=import.js.map

package/dist/cli/index.js

@@ -16,4 +16,3 @@ export function registerAllCommands(program) {
     registerResetCommand(program);
     registerImportCommand(program);
 }
-//# sourceMappingURL=index.js.map

package/dist/cli/init.js

@@ -161,4 +161,3 @@ async function initFromFile(filePath, cwd, detectedName) {
         `Open ${chalk.bold('teamcast.yaml')} to customize`,
     ]);
 }
-//# sourceMappingURL=init.js.map

package/dist/cli/manage.js

@@ -460,4 +460,3 @@ async function promptEditAgent(current, targetContext) {
         disallowedTools,
     });
 }
-//# sourceMappingURL=manage.js.map

package/dist/cli/registrars/diff.js

@@ -7,4 +7,3 @@ export function registerDiffCommand(program) {
         await runDiffCommand();
     });
 }
-//# sourceMappingURL=diff.js.map

package/dist/cli/registrars/explain.js

@@ -7,4 +7,3 @@ export function registerExplainCommand(program) {
         await runExplainCommand();
     });
 }
-//# sourceMappingURL=explain.js.map

package/dist/cli/registrars/generate.js

@@ -8,4 +8,3 @@ export function registerGenerateCommand(program) {
         await runGenerateCommand(options);
     });
 }
-//# sourceMappingURL=generate.js.map

package/dist/cli/registrars/import.js

@@ -8,4 +8,3 @@ export function registerImportCommand(program) {
         await runImportCommand(options);
     });
 }
-//# sourceMappingURL=import.js.map

package/dist/cli/registrars/init.js

@@ -11,4 +11,3 @@ export function registerInitCommand(program) {
         await runInitCommand(options);
     });
 }
-//# sourceMappingURL=init.js.map

package/dist/cli/registrars/manage.js

@@ -12,7 +12,7 @@ export function registerManageCommands(program) {
     const createCmd = program.command('create').description('Create a new resource');
     createCmd
         .command('skill <name>')
-        .description('Create a new skill (generates stub file in .claude/skills/)')
+        .description('Create a new skill (Claude: .claude/skills/, Codex: .agents/skills/)')
         .option('--target <name>', 'Target block to modify')
         .action(async (name, options) => {
         const { runCreateSkillCommand } = await import('../manage.js');
@@ -51,4 +51,3 @@ export function registerManageCommands(program) {
         await runEditAgentCommand(name, options);
     });
 }
-//# sourceMappingURL=manage.js.map

package/dist/cli/registrars/reset.js

@@ -16,4 +16,3 @@ export function registerResetCommand(program) {
         await runCleanCommand(options);
     });
 }
-//# sourceMappingURL=reset.js.map

package/dist/cli/registrars/validate.js

@@ -9,4 +9,3 @@ export function registerValidateCommand(program) {
         await runValidateCommand(options);
     });
 }
-//# sourceMappingURL=validate.js.map

package/dist/cli/reset.js

@@ -1,6 +1,6 @@
 import chalk from 'chalk';
 import { existsSync, rmSync, readdirSync, statSync } from 'fs';
-import { join } from 'path';
+import { dirname, join } from 'path';
 import { readManifest, ManifestError } from '../manifest/reader.js';
 import { generate } from '../generator/index.js';
 import { printSuccess, printHeader, printCommandSuccess, printDim, } from '../utils/chalk-helpers.js';
@@ -47,6 +47,22 @@ function deleteEmptyDirIfPossible(cwd, rel) {
         printSuccess(`Deleted ${rel}/`);
     }
 }
+function pruneEmptyAncestorDirs(cwd, rel) {
+    let current = dirname(rel);
+    while (current !== '.' && current !== '') {
+        const abs = join(cwd, current);
+        if (!existsSync(abs)) {
+            current = dirname(current);
+            continue;
+        }
+        if (readdirSync(abs).length > 0) {
+            break;
+        }
+        rmSync(abs, { recursive: true });
+        printSuccess(`Deleted ${current}/`);
+        current = dirname(current);
+    }
+}
 function deleteFiles(cwd, paths) {
     for (const rel of paths) {
         const abs = join(cwd, rel);
@@ -60,6 +76,7 @@ function deleteFiles(cwd, paths) {
             rmSync(abs);
         }
         printSuccess(`Deleted ${rel}`);
+        pruneEmptyAncestorDirs(cwd, rel);
     }
     deleteEmptyDirIfPossible(cwd, '.claude/agents');
     deleteEmptyDirIfPossible(cwd, '.claude/skills');
@@ -128,4 +145,3 @@ export async function runCleanCommand(options) {
     console.log('');
 }
 export { registerResetCommand } from './registrars/reset.js';
-//# sourceMappingURL=reset.js.map

package/dist/cli/validate.js

@@ -38,4 +38,3 @@ export function runValidateCommand(options) {
     }
 }
 export { registerValidateCommand } from './registrars/validate.js';
-//# sourceMappingURL=validate.js.map

package/dist/core/assertions.js

@@ -8,4 +8,3 @@ export const ASSERTION_RULES = [
     'require_delegation_chain',
     'no_unrestricted_execute',
 ];
-//# sourceMappingURL=assertions.js.map

package/dist/core/capability-resolver.js

@@ -15,4 +15,3 @@ export function agentHasCapability(agentTools, capability, mapping) {
     const requiredTools = mapping[capability];
     return requiredTools.length > 0 && requiredTools.some((t) => agentTools.includes(t));
 }
-//# sourceMappingURL=capability-resolver.js.map

package/dist/core/compose-policies.js

@@ -103,4 +103,3 @@ export function composePolicies(layers) {
     const merged = layers.reduce((acc, layer) => mergeTwoLayers(acc, layer.policies), {});
     return applyPriority(merged);
 }
-//# sourceMappingURL=compose-policies.js.map

package/dist/core/environment-resolver.js

@@ -199,4 +199,3 @@ export function applyEnvironmentInstructions(team, targetContext, envIds) {
     }));
     return changed ? { ...team, agents } : team;
 }
-//# sourceMappingURL=environment-resolver.js.map

package/dist/core/guards.js

@@ -17,4 +17,3 @@ export function isCoreTeam(value) {
         return false;
     return 'runtime' in firstAgent;
 }
-//# sourceMappingURL=guards.js.map

package/dist/core/instructions.js

@@ -30,4 +30,3 @@ export function renderInstructionBlocks(blocks) {
         .join('\n\n')
         .trim();
 }
-//# sourceMappingURL=instructions.js.map

package/dist/core/policy-evaluator.js

@@ -158,4 +158,3 @@ function checkNoUnrestrictedExecute(team, skillMap) {
     }
     return results;
 }
-//# sourceMappingURL=policy-evaluator.js.map

package/dist/core/types.js

@@ -3,4 +3,3 @@
 // after all legacy-format coercion and default application has been done.
 // This module must not import from manifest/ to avoid circular dependencies.
 export {};
-//# sourceMappingURL=types.js.map

package/dist/detector/index.js

@@ -48,4 +48,3 @@ export function detectProjectContext(cwd) {
     }
     return ctx;
 }
-//# sourceMappingURL=index.js.map

package/dist/diff/index.js

@@ -23,4 +23,3 @@ export function diffManifest(manifest, cwd) {
         return { path: file.path, status: 'modified', addedLines: added, removedLines: removed };
     });
 }
-//# sourceMappingURL=index.js.map

package/dist/explainer/index.js

@@ -90,4 +90,3 @@ export function buildExplanation(team, targetContext) {
     }
     return lines.join('\n');
 }
-//# sourceMappingURL=index.js.map

package/dist/generator/file-policies.js

@@ -1,4 +1,3 @@
 export function isUserEditableGeneratedFile(path) {
-    return path.startsWith('.claude/skills/');
+    return path.startsWith('.claude/skills/') || path.startsWith('.agents/skills/');
 }
-//# sourceMappingURL=file-policies.js.map

package/dist/generator/index.js

@@ -19,4 +19,3 @@ export function generate(manifest, options) {
     }
     return allGeneratedFiles;
 }
-//# sourceMappingURL=index.js.map

package/dist/generator/types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=types.js.map

package/dist/generator/writer.js

@@ -11,4 +11,3 @@ export function writeFiles(files, cwd, options) {
         writeFileSync(absPath, file.content, 'utf-8');
     }
 }
-//# sourceMappingURL=writer.js.map

package/dist/importer/claude.js

@@ -48,4 +48,3 @@ export const claudeImportHandler = {
     },
     importFromDir: importFromClaudeDir,
 };
-//# sourceMappingURL=claude.js.map

package/dist/importer/codex.js

@@ -47,4 +47,3 @@ export const codexImportHandler = {
     },
     importFromDir: importFromCodexDir,
 };
-//# sourceMappingURL=codex.js.map

package/dist/importer/index.js

@@ -35,4 +35,3 @@ export function importTargetFromDir(targetName, cwd, projectName) {
     }
     return handler.importFromDir(cwd, projectName);
 }
-//# sourceMappingURL=index.js.map

package/dist/importer/shared.js

@@ -370,4 +370,3 @@ export function parseCodexAgentFile(cwd, entry, targetContext) {
         warnings,
     };
 }
-//# sourceMappingURL=shared.js.map

package/dist/importer/types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=types.js.map

package/dist/index.js

@@ -38,4 +38,3 @@ catch (error) {
     }
     throw error;
 }
-//# sourceMappingURL=index.js.map

package/dist/manifest/defaults.js

@@ -81,4 +81,3 @@ export function applyDefaults(manifest) {
     }
     return nextManifest;
 }
-//# sourceMappingURL=defaults.js.map

package/dist/manifest/normalize.js

@@ -325,4 +325,3 @@ export function buildRuntimeFromCapabilities(capabilities) {
 export function ensureKnownTools(tools, knownTools) {
     return tools?.filter((tool) => knownTools.includes(tool));
 }
-//# sourceMappingURL=normalize.js.map

package/dist/manifest/reader.js

@@ -34,4 +34,3 @@ export function readManifest(cwd) {
     }
     return schemaResult.data;
 }
-//# sourceMappingURL=reader.js.map

package/dist/manifest/schema-validator.js

@@ -32,4 +32,3 @@ export function validateSchema(raw) {
     }));
     return { valid: false, errors };
 }
-//# sourceMappingURL=schema-validator.js.map

package/dist/manifest/targets.js

@@ -26,4 +26,3 @@ export function getManifestTargetEntries(manifest) {
     })
         .filter((entry) => Boolean(entry));
 }
-//# sourceMappingURL=targets.js.map

package/dist/manifest/types.js

@@ -1,4 +1,3 @@
 export function isInstructionBlock(value) {
     return typeof value.kind === 'string' && typeof value.content === 'string';
 }
-//# sourceMappingURL=types.js.map

package/dist/manifest/writer.js

@@ -6,4 +6,3 @@ export function writeManifest(manifest, cwd) {
     const content = stringify(manifest, { lineWidth: 0 });
     writeFileSync(manifestPath, content, 'utf-8');
 }
-//# sourceMappingURL=writer.js.map

package/dist/presets/index.js

@@ -104,4 +104,3 @@ export function applyPreset(preset, projectName) {
         },
     };
 }
-//# sourceMappingURL=index.js.map

package/dist/presets/types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=types.js.map

package/dist/registry/capabilities.js

@@ -11,4 +11,3 @@ export const CAPABILITIES = [
     { id: 'interact', description: 'User interaction' },
     { id: 'notebook', description: 'Jupyter notebooks' },
 ];
-//# sourceMappingURL=capabilities.js.map

package/dist/registry/environments.js

@@ -103,4 +103,3 @@ export function detectEnvironments(cwd) {
         .filter((env) => env.detect(cwd))
         .map((env) => env.id);
 }
-//# sourceMappingURL=environments.js.map

package/dist/registry/index.js

@@ -82,4 +82,3 @@ export class Registry {
 }
 // Default singleton instance
 export const defaultRegistry = new Registry();
-//# sourceMappingURL=index.js.map

package/dist/registry/instruction-fragments.js

@@ -109,4 +109,3 @@ export function resolveInstructionFragments(fragments, extraBlocks = []) {
     });
     return [...extraBlocks.map((blockEntry) => ({ ...blockEntry })), ...blocks];
 }
-//# sourceMappingURL=instruction-fragments.js.map

package/dist/registry/models.js

@@ -43,4 +43,3 @@ export const MODEL_CATALOG = {
         features: ['tools', 'fast'],
     },
 };
-//# sourceMappingURL=models.js.map

package/dist/registry/policy-fragments.js

@@ -46,4 +46,3 @@ export function composePoliciesFromFragments(fragments, overrides = {}) {
     layers.push({ label: 'inline', policies: overrides });
     return composePolicies(layers);
 }
-//# sourceMappingURL=policy-fragments.js.map

package/dist/registry/skills.js

@@ -179,4 +179,3 @@ export function getBuiltinSkill(id) {
 export function isBuiltinSkillId(id) {
     return BUILTIN_SKILLS.some((skill) => skill.id === id);
 }
-//# sourceMappingURL=skills.js.map

package/dist/registry/traits.js

@@ -106,4 +106,3 @@ export function mergeRuntimeWithTraits(base, capabilityTraits, capabilityMap) {
         disallowedTools: mergeUnique(composed.disallowedTools, base.disallowedTools),
     };
 }
-//# sourceMappingURL=traits.js.map

package/dist/registry/types.js

@@ -18,4 +18,3 @@ export const ENVIRONMENT_IDS = ['node', 'python'];
 export function isEnvironmentId(value) {
     return ENVIRONMENT_IDS.includes(value);
 }
-//# sourceMappingURL=types.js.map

package/dist/renderers/claude/agent-md.js

@@ -42,4 +42,3 @@ export function renderAllAgentMd(team) {
         content: renderAgentMd(agentId, agent),
     }));
 }
-//# sourceMappingURL=agent-md.js.map

package/dist/renderers/claude/docs.js

@@ -57,4 +57,3 @@ export function renderClaudeMd(team) {
         content: lines.join('\n'),
     };
 }
-//# sourceMappingURL=docs.js.map

package/dist/renderers/claude/index.js

@@ -30,4 +30,3 @@ export function createClaudeTarget() {
         reverseMapTools: reverseMapToolsToSkills,
     };
 }
-//# sourceMappingURL=index.js.map

package/dist/renderers/claude/policy-mapper.js

@@ -18,4 +18,3 @@ export function mapPoliciesToClaudePermissions(policies) {
         defaultMode: policies?.permissions?.defaultMode,
     };
 }
-//# sourceMappingURL=policy-mapper.js.map

package/dist/renderers/claude/settings.js

@@ -74,4 +74,3 @@ export function renderSettingsLocalJson() {
         content: JSON.stringify(local, null, 2) + '\n',
     };
 }
-//# sourceMappingURL=settings.js.map

package/dist/renderers/claude/skill-map.js

@@ -36,4 +36,3 @@ export function reverseMapToolsToSkills(tools) {
     }
     return { skills, remainingTools: [...remaining] };
 }
-//# sourceMappingURL=skill-map.js.map

package/dist/renderers/claude/skill-md.js

@@ -100,4 +100,3 @@ export function renderSkillMd(team) {
     }
     return files;
 }
-//# sourceMappingURL=skill-md.js.map

package/dist/renderers/claude/tools.js

@@ -7,4 +7,3 @@ export const CLAUDE_CODE_TOOLS = [
     'AskUserQuestion', 'TodoWrite', 'TodoRead',
     'NotebookEdit',
 ];
-//# sourceMappingURL=tools.js.map

package/dist/renderers/codex/agents-md.js

@@ -91,4 +91,3 @@ function collectSharedInstructions(team) {
     }
     return shared;
 }
-//# sourceMappingURL=agents-md.js.map

package/dist/renderers/codex/index.js

@@ -98,4 +98,3 @@ export function createCodexTarget() {
         reverseMapTools: reverseMapToolsToSkills,
     };
 }
-//# sourceMappingURL=index.js.map

package/dist/renderers/codex/skill-map.js

@@ -26,4 +26,3 @@ export function reverseMapToolsToSkills(tools) {
     const remainingTools = tools.filter((t) => !usedTools.has(t));
     return { skills, remainingTools };
 }
-//# sourceMappingURL=skill-map.js.map