@kelceyp/caw 1.0.19 → 1.0.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +21 -3
  2. package/dist/caw.js +6 -2
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -1,16 +1,34 @@
1
1
  # CAW
2
2
 
3
- CAW provides independently useful capabilities that combine to provide powerful context and agentic workflows enabling your agents to build software sustainably. All capabilities are dual channel. React based web application for humans and rich MCP capabilities for agents. Everything you can do, agents can do too.
3
+ CAW helps users build software **sustainably** using AI by providing agents with **C**ontext and **A**gentic **W**orkflows (CAW).
4
+
5
+ Agents are capable coders but struggle to build software sustainably as the codebase and its complexity grow. Code reveals only so much and agents do not inherently know which parts of it to read or what the underlying intent was. Technical debt, technical mess, architectural mismatch and a host of problems creep in over time to grind progress to a halt.
6
+
7
+ CAW enables users and agents to capture the architecture, intent, decisions and engineering discipline specific to a project as part of its knowledge base. Agents help build that knowledge base, use it while working and keep it aligned with the codebase as the project grows.
8
+
9
+ CAW also reduces friction in human-to-agent and agent-to-agent collaboration across different agent vendors.
10
+
11
+ **Engineering discipline is still needed, but now it's cheap.**
12
+
13
+ CAW combines independently useful capabilities into a powerful context and orchestration environment that helps agents build software sustainably. Every capability is available to humans through a React-based web application and to agents through rich MCP tooling.
14
+
15
+ **Everything you can do, agents can do too.**
16
+
17
+ CAW was used to build CAW recursively, with version N building version N+1. In doing so, CAW was continuously dogfooded, proving the approach on a substantial software system.
18
+
19
+ **CAW is free to download and runs locally.**
20
+
21
+ The prompts, templates and knowledge cartridges used to build CAW are also available as a free download from [Athena Design](https://athenadesign.com.au). The CAW user manual can be downloaded separately and imported into the shared store, making it available to users and agents across every project. Use the 'Import Bundle' feature in project settings and shared store settings.
4
22
 
5
23
  ![CAW overview](https://athenadesign.com.au/caw/documents-editor.png)
6
24
 
7
25
  ## Content Management
8
26
 
9
- Build your agent knowledge base in lock step with your code base.
27
+ Build your product knowledge base in lock step with your code base.
10
28
 
11
29
  - Extended MD capabilities including inline mermaid, inline SVG, linking and includes
12
30
  - Monaco editor and extended marked rendering capabilities for users
13
- - Real time SSE updates
31
+ - SSE updates to keep you abreast of what's happening in real time
14
32
  - Typed metadata including multivalued fields
15
33
  - Locking, clobber protection and version control
16
34
  - Image deduping and easy pasting/viewing
package/dist/caw.js CHANGED
@@ -10805,10 +10805,12 @@ function createPidManager(envDir) {
10805
10805
  start(mainJsPath, envVars, nodeArgs = []) {
10806
10806
  const logPath = logFilePath(envDir);
10807
10807
  const logFd = fs5.openSync(logPath, "a");
10808
+ const env2 = { ...process.env, ...envVars };
10809
+ delete env2.CAW_DEVELOPER_TOOLS;
10808
10810
  const child = spawn(process.execPath, [...nodeArgs, mainJsPath], {
10809
10811
  detached: true,
10810
10812
  stdio: ["ignore", logFd, logFd],
10811
- env: { ...process.env, ...envVars }
10813
+ env: env2
10812
10814
  });
10813
10815
  writePid(envDir, child.pid);
10814
10816
  child.unref();
@@ -10885,7 +10887,9 @@ function createPm2Manager(envDir, checkPm2 = isPm2Installed) {
10885
10887
  const logPath = logFilePath(envDir);
10886
10888
  const envArgs = Object.entries(envVars).map(([k, v]) => `${k}=${v}`).join(" ");
10887
10889
  const nodeArgsStr = nodeArgs.length > 0 ? ` --node-args="${nodeArgs.join(" ")}"` : "";
10888
- execSync3(`${envArgs} pm2 start ${mainJsPath} --name ${name}${nodeArgsStr} --output ${logPath} --error ${logPath} --merge-logs`, { stdio: "inherit", env: { ...process.env, ...envVars } });
10890
+ const env2 = { ...process.env, ...envVars };
10891
+ delete env2.CAW_DEVELOPER_TOOLS;
10892
+ execSync3(`${envArgs} pm2 start ${mainJsPath} --name ${name}${nodeArgsStr} --output ${logPath} --error ${logPath} --merge-logs`, { stdio: "inherit", env: env2 });
10889
10893
  return name;
10890
10894
  },
10891
10895
  isRunning() {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kelceyp/caw",
3
- "version": "1.0.19",
3
+ "version": "1.0.21",
4
4
  "description": "CAW launcher — server lifecycle management CLI",
5
5
  "type": "module",
6
6
  "bin": {