teamcast 1.0.0 → 1.0.2

package/README.md

@@ -432,6 +432,9 @@ It targets:
 - `.claude/settings.json`
 - `.claude/settings.local.json`
 - `CLAUDE.md`
+- `.codex/agents`
+- `.codex/config.toml`
+- `AGENTS.md`
 
 Flow:
 
@@ -642,6 +645,7 @@ claude:
 | `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                                                                    |
+| `capability_traits`       | string[]                                                         | High-level capability profiles that expand to `tools` + `disallowed_tools`                     |
 | `instruction_blocks`      | object[]                                                         | Structured instruction blocks rendered into Claude markdown and Codex `developer_instructions` |
 | `instruction_fragments`   | string[]                                                         | Named instruction fragments composed with `instruction_blocks`                                 |
 | `forge.handoffs`          | string[]                                                         | Other agents this agent can delegate to. Requires `Agent` in `claude.tools`                    |
@@ -675,6 +679,39 @@ developer:
 
 Raw tool names and skills can be mixed in the same `tools` array.
 
+### Capability Traits
+
+Capability traits are high-level profiles that compose `tools` and `disallowed_tools` from named capability sets. They are the recommended way to define agent permissions in presets and custom manifests — more readable than raw tool lists and safer than manual assembly.
+
+| Trait                | Grants                          | Denies          |
+| -------------------- | ------------------------------- | --------------- |
+| `base-read`          | `read_files`, `search`          | —               |
+| `file-authoring`     | `write_files`                   | —               |
+| `command-execution`  | `execute`                       | —               |
+| `web-research`       | `web`                           | —               |
+| `delegation`         | `delegate`                      | —               |
+| `interaction`        | `interact`                      | —               |
+| `notebook-editing`   | `notebook`                      | —               |
+| `no-file-edits`      | —                               | `write_files`   |
+| `no-commands`        | —                               | `execute`       |
+| `no-web`             | —                               | `web`           |
+| `full-access`        | all capabilities                | —               |
+
+Grant traits expand to the corresponding abstract skills (see table above). Deny traits add the expanded tools to `disallowed_tools`.
+
+Traits are combined in order. If you need a read-only planner that can browse the web but cannot edit files or run commands:
+
+```yaml
+planner:
+  capability_traits:
+    - base-read
+    - web-research
+    - no-file-edits
+    - no-commands
+```
+
+Traits merge with explicit `tools` and `disallowed_tools` — you can use both in the same agent definition. Explicit tool lists take precedence for additions; deny traits always add to the disallow list.
+
 ### Policy Fields
 
 ```yaml

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

@@ -14,4 +14,3 @@ export function buildGeneratedOutputs(team, targetName, options) {
     }
     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

@@ -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

@@ -128,4 +128,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/');
 }
-//# 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

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

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

package/dist/renderers/codex/tools.js

@@ -5,4 +5,3 @@ export const CODEX_TOOLS = [
     'search_codebase',
     'web_search',
 ];
-//# sourceMappingURL=tools.js.map

package/dist/renderers/registry.js

@@ -40,4 +40,3 @@ export function getRegisteredTargetNames() {
     ensureBuiltinTargetsRegistered();
     return Array.from(registry.keys());
 }
-//# sourceMappingURL=registry.js.map

package/dist/renderers/target-context.js

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

package/dist/renderers/types.js

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

package/dist/team-templates/policies.js

@@ -54,4 +54,3 @@ const POLICY_BUNDLES = {
 export function createPolicies(bundle) {
     return composePoliciesFromFragments(POLICY_BUNDLES[bundle]);
 }
-//# sourceMappingURL=policies.js.map

package/dist/team-templates/presets.js

@@ -12,4 +12,3 @@ export function buildPresetManifest(name) {
     const preset = loadPreset(name);
     return preset.team;
 }
-//# sourceMappingURL=presets.js.map

package/dist/team-templates/roles.js

@@ -143,4 +143,3 @@ export function createRoleAgent(name, targetContext, overrides = {}) {
             : undefined,
     };
 }
-//# sourceMappingURL=roles.js.map

package/dist/tools/types.js

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

package/dist/types/manifest.js

@@ -11,4 +11,3 @@ export { CODEX_TOOLS } from '../renderers/codex/tools.js';
 // Functions to convert a raw TeamCastManifest into a fully-resolved CoreTeam,
 // and back again for serialization.
 export { normalizeManifest, denormalizeTarget, createManifestForTarget, replaceManifestTarget, } from '../manifest/normalize.js';
-//# sourceMappingURL=manifest.js.map

package/dist/utils/chalk-helpers.js

@@ -48,4 +48,3 @@ export function printNextSteps(steps) {
     }
     console.log('');
 }
-//# sourceMappingURL=chalk-helpers.js.map

package/dist/utils/prompts.js

@@ -48,4 +48,3 @@ export async function promptCheckbox(options) {
     ]);
     return answers.value;
 }
-//# sourceMappingURL=prompts.js.map

package/dist/utils/skill-prompt-options.js

@@ -9,4 +9,3 @@ export function getSupportedSkills(targetContext) {
     const allSkills = CAPABILITIES.map((cap) => cap.id);
     return allSkills.filter((skill) => (targetContext.skillMap[skill]?.length ?? 0) > 0);
 }
-//# sourceMappingURL=skill-prompt-options.js.map

package/dist/validator/checks/capability-policy.js

@@ -37,4 +37,3 @@ export function checkCapabilityPolicyCross(team, skillMap) {
     }
     return results;
 }
-//# sourceMappingURL=capability-policy.js.map

package/dist/validator/checks/capability-tools.js

@@ -20,4 +20,3 @@ _skillMap) {
     }
     return results;
 }
-//# sourceMappingURL=capability-tools.js.map

package/dist/validator/checks/environment.js

@@ -25,4 +25,3 @@ export function checkEnvironments(team) {
     }
     return results;
 }
-//# sourceMappingURL=environment.js.map

package/dist/validator/checks/handoff-graph.js

@@ -63,4 +63,3 @@ export function checkHandoffGraph(team, skillMap) {
     }
     return results;
 }
-//# sourceMappingURL=handoff-graph.js.map

package/dist/validator/checks/instructions.js

@@ -166,4 +166,3 @@ export function checkInstructions(team, skillMap) {
     }
     return results;
 }
-//# sourceMappingURL=instructions.js.map

package/dist/validator/checks/manifest-registry.js

@@ -65,4 +65,3 @@ export function checkManifestRegistry(manifest) {
     }
     return results;
 }
-//# sourceMappingURL=manifest-registry.js.map

package/dist/validator/checks/mcp.js

@@ -70,4 +70,3 @@ export function checkMcpServers(team, targetName) {
     }
     return results;
 }
-//# sourceMappingURL=mcp.js.map